Skip to main content
Only Super Admins can manage the license for an OpenHands Enterprise installation. Get a license key from Customer Center.

First-Time Installs

On a new Docker Compose or Helm installation, the setup wizard asks for your license key when the first Super Admin signs in. Enter your license key there.

Alternative: Set License Key in Your Configuration

Instead of using the setup wizard, you can set the license key in your installation’s configuration:
Add the license key to your values.yaml:
values.yaml
Then apply it with helm install, or with helm upgrade on an existing release. The chart stores the key in the openhands-license Secret and passes it to OpenHands as OPENHANDS_LICENSE_KEY.
  • For an installation that can’t reach Customer Center, pass an offline license file instead with --set-file license.offlineLicense=<path-to-license-file>.
  • To use a Secret you manage, set license.existingSecret to its name. The Secret needs a license-key or offline-license entry. Restart the openhands pods after you change the Secret.
For all license variables, see Environment Variables. A license set in your installation’s configuration takes precedence over the License page in the Super Admin Dashboard and can’t be changed there.

Existing Installs

We recommend adding or changing the license in the Super Admin Dashboard:
  1. Open Settings.
  2. Click your name in the lower left, then click Super Admin Dashboard.
  3. Click License in the navigation.
  4. Enter your license key, or upload your offline license file.
You can also set the license in your installation’s configuration: