Skip to main content

Documentation Index

Fetch the complete documentation index at: https://allhandsai-remove-v0-docs.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

This page documents the current V1 configuration model.OpenHands V0 configuration docs have been removed from this site. If you arrived from an old bookmark, see the V0 documentation deprecation notice.

​
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
    • LLM_API_KEY
    • LLM_MODEL
  • Persistence
    • OH_PERSISTENCE_DIR: where OpenHands stores local state (defaults to ~/.openhands).
  • Public URL (optional)
    • OH_WEB_URL: the externally reachable URL of your OpenHands instance (used for callbacks in some deployments).
  • Sandbox workspace mounting
    • SANDBOX_VOLUMES: mount host directories into the sandbox (see Docker Sandbox).
  • Sandbox image selection
    • AGENT_SERVER_IMAGE_REPOSITORY
    • AGENT_SERVER_IMAGE_TAG

​
Sandbox provider selection

Some deployments still use the legacy RUNTIME environment variable to choose which sandbox provider to use:
  • RUNTIME=docker (default)
  • RUNTIME=process (aka legacy RUNTIME=local)
  • RUNTIME=remote
See Sandboxes overview for details.

​
Looking for removed V0 options?

If you are looking for the old config.toml reference or V0 “runtime” providers, start with these V1 pages instead: