> ## 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.

# Configuration Options

> How to configure OpenHands V1 (Web UI, env vars, and sandbox settings).

<Note>
  This page documents the current <b>V1</b> configuration model.

  Legacy <code>config.toml</code> / “runtime” configuration docs have been moved
  to the <b>Legacy (V0)</b> section of the Web tab.
</Note>

## Where configuration lives in V1

Most user-facing configuration is done via the **Settings** UI in the Web app
(LLM provider/model, integrations, MCP, secrets, etc.).

For self-hosted deployments and advanced workflows, OpenHands also supports
environment-variable configuration.

## Common V1 environment variables

These are some commonly used variables in V1 deployments:

* **LLM credentials**
  * <code>LLM\_API\_KEY</code>
  * <code>LLM\_MODEL</code>

* **Persistence**
  * <code>OH\_PERSISTENCE\_DIR</code>: where OpenHands stores local state (defaults to
    <code>\~/.openhands</code>).

* **Public URL (optional)**
  * <code>OH\_WEB\_URL</code>: the externally reachable URL of your OpenHands instance
    (used for callbacks in some deployments).

* **Sandbox workspace mounting**
  * <code>SANDBOX\_VOLUMES</code>: mount host directories into the sandbox (see
    [Docker Sandbox](/openhands/usage/sandboxes/docker)).

* **Sandbox image selection**
  * <code>AGENT\_SERVER\_IMAGE\_REPOSITORY</code>
  * <code>AGENT\_SERVER\_IMAGE\_TAG</code>

## Sandbox provider selection

Some deployments still use the legacy <code>RUNTIME</code> environment variable to
choose which sandbox provider to use:

* <code>RUNTIME=docker</code> (default)
* <code>RUNTIME=process</code> (aka legacy <code>RUNTIME=local</code>)
* <code>RUNTIME=remote</code>

See [Sandboxes overview](/openhands/usage/sandboxes/overview) for details.

## Need legacy options?

If you are looking for the old <code>config.toml</code> reference or V0 “runtime”
providers, see:

* <b>Web → Legacy (V0) → V0 Configuration Options</b>
* <b>Web → Legacy (V0) → V0 Runtime Configuration</b>