openclaw/crabbox
openclaw/crabbox
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 9 Wiki Activity
e0a85bc780
crabbox/docs/features/daytona.md
Peter Steinberger e0a85bc780
feat: add Daytona and Islo providers
2026-05-06 07:52:15 +01:00

2.2 KiB
Raw Blame History

Daytona

Read when:

  • choosing provider: daytona;
  • configuring Daytona auth, snapshots, or SSH access;
  • reviewing Daytona provider behavior.

provider: daytona provisions Daytona sandboxes from snapshots. run and warmup use Daytona's SDK/toolbox for workspace upload and command execution; ssh mints a short-lived Daytona SSH token only when interactive shell access is requested.

Auth

Set one of:

export DAYTONA_API_KEY=...

or:

export DAYTONA_JWT_TOKEN=...
export DAYTONA_ORGANIZATION_ID=...

DAYTONA_ORGANIZATION_ID is required when JWT auth is used. DAYTONA_API_URL or daytona.apiUrl can override the default https://app.daytona.io/api.

Config

Daytona's first Crabbox integration is snapshot-first. The snapshot owns CPU, memory, disk, and installed tooling. Crabbox does not expose Daytona resource flags in this mode.

provider: daytona
target: linux
daytona:
  snapshot: crabbox-ready
  target: ""
  user: daytona
  workRoot: /home/daytona/crabbox
  sshGatewayHost: ssh.app.daytona.io # fallback when the API omits sshCommand
  sshAccessMinutes: 30

Equivalent flags:

crabbox warmup --provider daytona --daytona-snapshot crabbox-ready
crabbox run --provider daytona --id <slug> -- pnpm test
crabbox stop --provider daytona <slug>

Behavior

  • warmup creates a Daytona sandbox from daytona.snapshot, waits for the sandbox, records Crabbox labels, then prints a normal Crabbox lease ID and slug.
  • run --id resolves a Daytona sandbox, uploads a Crabbox manifest archive through Daytona toolbox file APIs, extracts it in the sandbox, and executes the command through Daytona toolbox process APIs.
  • list, status, and stop use Daytona sandbox labels to find Crabbox-owned sandboxes.
  • ssh mints a fresh Daytona SSH token, parses the host and port returned by Daytona's sshCommand, and redacts the token as <token> unless --show-secret is used.

Daytona is a hybrid backend: core rendering, lease labels, sync manifests, and repo claim checks stay Crabbox-owned, while the actual run transport is Daytona SDK/toolbox. Actions runner hydration is not supported for Daytona warmup because it requires a normal long-lived SSH runner host.