Skip to main content

Agent Daytona Sandboxes

The agent runner can create Daytona sandboxes for agent runs. Configure Daytona on the runner service, not on every Agenta container.

Configure the runner​

SANDBOX_AGENT_PROVIDER=daytona
DAYTONA_API_KEY=<daytona-api-key>
DAYTONA_API_URL=https://app.daytona.io/api
DAYTONA_TARGET=eu

For Helm:

agentRunner:
  provider: daytona
  daytona:
    apiKey: <daytona-api-key>
    apiUrl: https://app.daytona.io/api
    target: eu

Optional snapshot​

Daytona runs start faster from a prepared snapshot. Agenta ships the recipe, not a prebuilt snapshot:

cd services/runner/sandbox-images/daytona
uv run build_snapshot.py --force

Then configure the snapshot name:

DAYTONA_SNAPSHOT=agenta-sandbox-pi
AGENTA_AGENT_SANDBOX_PI_INSTALLED=false

For Helm:

agentRunner:
  daytona:
    snapshot: agenta-sandbox-pi
    installPi: false

Store endpoint for remote sandboxes​

Daytona sandboxes run in the cloud and mount durable storage over the public internet. The store endpoint must be publicly reachable. If you run compose locally, enable the remote compose profile (ngrok tunnel). On Railway and Kubernetes the store endpoint is already public.

See the Store configuration reference.