Installation

cspace v1 is macOS-only (Apple Container substrate). Linux substrate support is post-1.0.

Install the CLI

Stable (currently v0.x; v1 ships when v1.0.0 is tagged):

brew install elliottregan/cspace/cspace

Release candidate (v1.0.0-rc.x):

brew install elliottregan/cspace/cspace-rc

The two casks are mutually exclusive — pick one. Verify:

cspace version

Build the sandbox image

cspace v1 needs a local sandbox image (cspace:latest). Until image distribution lands (#68), this is a one-time per-host step:

cspace image build

Takes 1–2 minutes on a warm machine. Idempotent — re-running is fast if the embedded library hasn’t changed.

Install the DNS resolver

cspace serves a small DNS zone (*.cspace2.local) so sandboxes are reachable by hostname from the host browser:

cspace dns install

This writes /etc/resolver/cspace2.local and prompts for sudo. One-time per host.

Verify

cspace doctor

Should show all green for: Apple Container CLI, cspace daemon (HTTP + DNS), DNS routing, and credentials.

Next

Quick start →