Skip to main content
E2B is the default — and currently only — sandbox provider Dari supports. Each session gets its own E2B sandbox, built from a template derived from your agent’s prepared runtime.

​
Configuration

Declare E2B in dari.yml and reference a stored credential for your E2B API key: 
sandbox:
  provider: e2b
  provider_api_key_secret: E2B_API_KEY
FieldRequiredNotes
provideryesMust be e2b.
provider_api_key_secretyesName of a stored org credential holding your E2B API key. Must match ^[A-Z_][A-Z0-9_]*$. Never put the raw key here.
The credential referenced by provider_api_key_secret is resolved at session start and used to authenticate against E2B for both sandbox creation and reconnection.

​
Base image

If you omit the runtime block in dari.yml, Dari uses the default E2B base image (e2bdev/base:latest) and copies your bundle to /bundle inside the sandbox. To install extra system packages or use a different base distro, add a Dockerfile at the repo root and reference it: 
runtime:
  dockerfile: Dockerfile
See the manifest reference for the full contract.

​
Getting an API key

  1. Sign up at e2b.dev.
  2. Create an API key from your E2B dashboard.
  3. Store it as an org credential named E2B_API_KEY (or any ^[A-Z_][A-Z0-9_]*$ name you prefer) and reference it from dari.yml.