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:- Helm
- Docker Compose
Add the license key to your Then apply it with
values.yaml:values.yaml
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.existingSecretto its name. The Secret needs alicense-keyoroffline-licenseentry. Restart theopenhandspods after you change the Secret.
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:- Open
Settings. - Click your name in the lower left, then click
Super Admin Dashboard. - Click
Licensein the navigation. - Enter your license key, or upload your offline license file.
- Helm or Docker Compose: Follow Alternative: Set License Key in Your Configuration.
- Replicated VM: In the Admin Console configuration,
open the
Licensesection. Choose aLicense Type, enter yourLicense Keyor upload your offline license file, then apply the change.

