Skip to main content
OpenHands Enterprise reads its configuration from environment variables. Each table lists the default that OpenHands uses when you don’t set the variable. The Helm chart and the Docker Compose stack set many of these variables for you, so your installation can use a different value. Set boolean variables to true or false.

Set a Variable

Many variables have a dedicated value in the Helm chart, such as smtp.host or github.enabled, and the chart sets the variable for you. See the chart’s configuration reference for those values.To set any variable on this page directly, add it under env in your values and apply them with helm upgrade. An env entry takes precedence over the value that the chart sets for the same variable.
values.yaml

General

License

Database

For production, we recommend your own PostgreSQL. See External PostgreSQL.

Redis

Conversation Storage

Use an S3-compatible store, Google Cloud Storage, or a local directory. Google Cloud Storage uses the workload’s service account. For Amazon S3 on EKS, see object storage.

Authentication

Keycloak

Users and Organizations

LLM

By default, OpenHands routes LLM requests through a LiteLLM proxy, which manages each user’s key and budget. See LLM Gateways for provider examples. To give every new user the same model and key without LiteLLM, set OPENHANDS_LLM_PROVIDER_ROUTE to direct:

Sandboxes

Runtime API

These variables apply when RUNTIME is remote. The Runtime API sets the sandbox image and environment. For sandbox CPU and memory on Kubernetes, see Resource Limits.

Docker

These variables apply when RUNTIME is unset.

Workspace Archives

With the Runtime API, OpenHands can archive a conversation’s workspace to object storage before it deletes the sandbox.

Automations

For a Helm installation, see Enable Automations with Helm.

Automation Service

The automation service runs separately from OpenHands and reads its own variables. On Helm, the automation subchart sets most of them for you. To set one directly, add it under automation.env in your values. In the Docker Compose stack, add it to .env.

Database

Storage

The automation service stores uploaded automation files. Its storage variables have the same names as the ones in Conversation Storage, but they take different values. The Docker Compose stack keeps automation files in a local volume, so storage variables in .env apply only to OpenHands.

Runs

Git Sync

Each organization sets its own repository on the Git Sync page. These variables set the defaults.

Plugins

See Plugin Marketplace.

Source Control

These variables apply to every Git provider.

GitHub

See GitHub.

GitLab

See GitLab.

Bitbucket Cloud

Bitbucket Data Center

See Bitbucket Data Center.

Azure DevOps

See Azure DevOps.

Jira

Jira Cloud

See Jira Cloud.

Jira Data Center

See Jira Data Center.

Slack

See Slack.

Email

OpenHands sends email, such as organization invitations, through your SMTP server.

Limits

Feature Flags

These variables show or hide parts of the app.

Telemetry and Observability

See Analytics.