alineo init

bunx alineo-cli init

What it does

Checks that Docker is running.
If an OpenSandbox container named alineo-opensandbox is already running, exits immediately — nothing changes.
If the container exists but is stopped, restarts it.
Otherwise, pulls opensandbox/server:latest and starts it, mounting the Docker socket so the server can manage sandbox containers.
Waits up to 60 seconds for the server to report healthy.
Writes alineo.config.json in the current directory (project root) if it doesn't already exist.

The server it starts is configured with credential injection available out of the box — a sandbox that opts in with networkPolicy/credentialProxy can use sb.credentials.* with no extra setup on the server side. See Credentials. Sandboxes that don't ask for it are unaffected.

Output files

`alineo.config.json`

Written once, in the project root (not under .alineo/). Contains the connection details and defaults used by both the alineo CLI and the alineo SDK package.

{
  "serverUrl": "http://127.0.0.1:8080",
  "useServerProxy": true,
  "apiKey": "",
  "adapterPath": "./.alineo/ledger.db",
  "agentsDir": "./agents",
  "defaults": {
    "resources": { "cpu": "1000m", "memory": "1Gi" }
  }
}

Field	Description
`serverUrl`	The OpenSandbox server URL.
`useServerProxy`	Always `true` when started via `alineo init`. The `alineo` SDK package reads this for its `Sandbox` client.
`apiKey`	Empty for local dev. Set this if your server requires authentication.
`adapterPath`	Path to the SQLite ledger database for this project.
`agentsDir`	Directory `alineo add`/`list`/`remove` read and write agent spec files in.
`defaults.resources`	CPU/memory used for an agent's sandbox when its spec omits `resources`.

Idempotency

alineo init is safe to run multiple times. If the server is already running it prints the URL and exits. If alineo.config.json already exists it is not overwritten.

Docker requirements

Docker Engine must be running before calling alineo init.
Port 8080 must be free.
The Docker socket /var/run/docker.sock must be accessible (standard on Linux and macOS with Docker Desktop).

Stopping the server

alineo init starts the server but does not provide a stop command. To stop it:

docker stop alineo-opensandbox

To remove the container entirely:

docker rm alineo-opensandbox

The next alineo init will start a fresh container.