Skip to main content
Daytona provides provider-managed remote sandboxes. Use it when you want a remote workspace per task without consuming local compute, especially for SWE-bench and Terminal-Bench smoke tests.
NeedLink
Create an account and manage sandboxesDaytona Dashboard
Create API keysDaytona API keys page
Getting started docsDaytona documentation
API key docsDaytona API keys

​
First-Time Setup

  1. Create a Daytona account from the official dashboard.
  2. Open the API keys page and create a key with sandbox permissions.
  3. Export the key in the shell that runs AgentCompass.
  4. Run a single task before increasing concurrency.
export DAYTONA_API_KEY="..."
export DAYTONA_API_URL="https://your-daytona-api"  # optional
export DAYTONA_TARGET="your-target"               # optional
DAYTONA_API_KEY is the only value most users need. DAYTONA_API_URL and DAYTONA_TARGET are optional and should be set only when your Daytona workspace requires a non-default API endpoint or target. AgentCompass authentication precedence is:
SourceUse when
environments.daytona.api_keyYou intentionally keep credentials in a private --config file.
DAYTONA_API_KEYRecommended for shell sessions, CI, and shared scripts.
DAYTONA_API_URL / DAYTONA_TARGETOptional endpoint and target overrides.
Do not commit Daytona API keys to config/defaults.yaml. Use environment variables or a private config file passed with --config.

​
Verify Credentials

The most useful verification is an AgentCompass smoke test because it checks credentials, sandbox startup, recipe image selection, file operations, and harness execution together.

​
Single Terminal-Bench Instance

agentcompass run \
  terminal_bench_2 \
  terminus2 \
  your-model \
  --env daytona \
  --benchmark-params '{"sample_ids":["overfull-hbox"]}' \
  --model-base-url "$MODEL_BASE_URL" \
  --model-api-key "$MODEL_API_KEY"
This is the recommended provider smoke test because it runs one task and lets the recipe infer the task image.

​
Provider Params

Common Daytona overrides live under environments.daytona or --env-params:
FieldUse
api_keyPrivate config alternative to DAYTONA_API_KEY.
api_urlOverride the Daytona API endpoint.
targetOverride the Daytona target.
imageUse a Docker image when no recipe should select the image.
snapshotUse a Daytona snapshot for faster or prebuilt startup.
delete_on_closeSet false while debugging a sandbox.
sandbox_start_timeoutIncrease when images or snapshots start slowly.
operation_timeoutIncrease for long file or process operations.
env_variablesInject non-secret environment variables into the sandbox.

​
SWE-bench Verified

agentcompass run \
  swebench_verified \
  mini_swe_agent \
  your-model \
  --env daytona \
  --benchmark-params '{"sample_ids":["astropy__astropy-12907"]}' \
  --model-base-url "$MODEL_BASE_URL" \
  --model-api-key "$MODEL_API_KEY"
Recipes set compatible images and workspaces for supported benchmark/provider pairs. Pass --env-params only for deliberate overrides.