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

# Configure License Key

> Add or change the license key for an OpenHands Enterprise installation.

Only Super Admins can manage the license for an OpenHands Enterprise installation. Get a license key from
[Customer Center](https://customercenter.openhands.dev).

## First-Time Installs

On a new [Docker Compose or Helm](https://docs.openhands.dev/enterprise/overview.md) installation, the
[setup wizard](https://docs.openhands.dev/enterprise/super-admin.md#first-install-setup) 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:

> [tab] Helm
>
> Add the license key to your `values.yaml`:
>
> ```yaml values.yaml theme={null}
> license:
>   key: "<license-key>"
> ```
>
> 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.

> [tab] Docker Compose
>
> Add the license key to the `.env` file in the `enterprise` directory:
>
> ```bash .env theme={null}
> OPENHANDS_LICENSE_KEY=<license-key>
> ```
>
> Then restart the stack:
>
> ```bash theme={null}
> ./scripts/setup.sh
> ```

For all license variables, see [Environment Variables](https://docs.openhands.dev/enterprise/environment-variables.md#license). 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:

* **Helm or Docker Compose**: Follow [Alternative: Set License Key in Your Configuration](#alternative-set-license-key-in-your-configuration).
* **Replicated VM**: In the [Admin Console configuration](https://docs.openhands.dev/enterprise/vm-install/admin-console-configuration.md#open-the-configuration-screen),
  open the `License` section. Choose a `License Type`, enter your `License Key` or upload your offline license file,
  then [apply the change](https://docs.openhands.dev/enterprise/vm-install/admin-console-configuration.md#apply-a-configuration-change).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.