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

# E2B Runtime

> E2B is an open-source secure cloud environment (sandbox) made for running AI-generated code and agents.

<Note>
  This page documents **legacy OpenHands V0** behavior. For the current V1
  sandbox model, see [Sandboxes (V1)](/openhands/usage/sandboxes/overview).
</Note>

[E2B](https://e2b.dev) offers [Python](https://pypi.org/project/e2b/) and [JS/TS](https://www.npmjs.com/package/e2b)
SDK to spawn and control these sandboxes.

## Getting started

1. [Get your API key](https://e2b.dev/docs/getting-started/api-key)

2. Set your E2B API key to the `E2B_API_KEY` env var when starting the Docker container

3. **Optional** - Install the CLI with NPM.
   ```sh theme={null}
   npm install -g @e2b/cli@latest
   ```
   Full CLI API is [here](https://e2b.dev/docs/cli/installation).

## OpenHands sandbox

You can use the E2B CLI to create a custom sandbox with a Dockerfile. Read the full guide
[here](https://e2b.dev/docs/templates/quickstart). The premade OpenHands sandbox for E2B is set up in the `containers`
directory, and it's called `openhands`.

## Debugging

You can connect to a running E2B sandbox with E2B CLI in your terminal.

* List all running sandboxes (based on your API key)
  ```sh theme={null}
  e2b sandbox list
  ```

* Connect to a running sandbox
  ```sh theme={null}
  e2b sandbox connect <sandbox-id>
  ```

## Links

* [E2B Docs](https://e2b.dev/docs)
* [E2B GitHub](https://github.com/e2b-dev/e2b)