> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirage.strukto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# E2B

> Run captured command lines in an existing E2B sandbox.

`E2BRuntime` connects to a live [E2B](https://e2b.dev) sandbox by id. Create
it with E2B's CLI or SDK from a template carrying Mirage and `fuse3`, then
provision the workspace inside it. Mirage only connects and executes; it never
creates, starts, stops, or deletes the sandbox.

See the [Sandbox overview](/python/runtime/sandbox) for the shared image and
matching mount-prefix setup.

## Install

```bash theme={null}
pip install mirage-ai[e2b]
```

## Configure

```yaml theme={null}
runtimes:
  - name: e2b
    captures: ["python3", "pip"]
    config:
      sandbox_id: ${E2B_SANDBOX_ID}
      api_key: ${E2B_API_KEY}
  - vfs
```

`api_key` is optional when `E2B_API_KEY` is set. The runtime connects on the
first captured line and reuses the sandbox client until the workspace closes.
Closing the workspace releases the client and leaves the sandbox running.

The same configuration in application code is:

```python theme={null}
from mirage.runtime.sandbox.e2b import E2BRuntime

runtime = E2BRuntime(
    captures=["python3", "pip"],
    config={"sandbox_id": "sandbox-id"},
)
```

Templates, CPU and memory sizing, networking, and lifecycle controls remain
E2B settings.

<Warning>
  Mirage timeouts stop waiting rather than terminating the remote process. E2B
  also applies its SDK command timeout, currently 60 seconds by default, to
  both runaway and legitimate long-running commands. See
  [Resource limits](/python/runtime/sandbox#resource-limits).
</Warning>