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

# E2B

> Run Roomote tasks on E2B-hosted sandboxes using a Roomote worker template.

E2B is a hosted sandbox provider for running task sandboxes away from the
Roomote server. Roomote uses an E2B template built from the Roomote worker
runtime, then starts task sandboxes from that template.

## When to use E2B

Use E2B when:

* task work should run outside the Roomote host
* you want hosted sandboxes with snapshot support
* you can provide an E2B API key
* your deployment can reach E2B and E2B task sandboxes can reach Roomote

## Configuration

Add E2B from **Settings > Sandboxes** with your API key, or provide the values
as deployment env vars:

```sh theme={null}
E2B_API_KEY=...
```

Roomote provisions the worker template automatically from the configured worker
image (`DOCKER_WORKER_IMAGE` or release derivation). You can also pin the
template as an env var:

```sh theme={null}
E2B_TEMPLATE_ID=roomote-worker:<tag>
```

Optional values:

```sh theme={null}
E2B_DOMAIN=e2b.app
E2B_MAX_SANDBOX_TIMEOUT_MS=3600000
```

Use `E2B_DOMAIN` only for self-hosted or custom E2B clusters. The default E2B
domain is enough for standard hosted E2B.

## Worker template expectations

The E2B template should contain the Roomote worker runtime: system packages,
browser tooling, language tools, command helpers, and the worker bootstrap used
to connect back to Roomote.

Settings and setup only collect the API key — not a template ID field. Roomote
builds the template from the worker image during setup when needed. For
production, keep the worker image or template version pinned so task startup is
predictable.

## Verify setup

1. save `E2B_API_KEY` (and let Roomote provision the template, or set
   `E2B_TEMPLATE_ID` in the deployment env)
2. select E2B as the default sandbox provider
3. start a small task from an environment
4. confirm the task starts, streams logs, and can run project commands
5. verify preview links if the task starts a web app

## Common issues

* **E2B reports a missing template.** Confirm auto-provisioning finished, or
  that `E2B_TEMPLATE_ID` matches a template available to the configured API
  key.
* **Tasks start with missing tools.** Rebuild or refresh the worker template
  from the current Roomote worker image.
* **Preview links fail.** Confirm the deployment URL and preview proxy are
  reachable from hosted sandboxes.