Files
coder/docs/admin/licensing/index.md
T
blinkagent[bot] d2950e7615 docs: document that license validation works offline (#24013)
## What

Documents that Coder license keys are validated locally using
cryptographic signatures and do not require an outbound connection to
Coder's servers. This is a common question from customers evaluating
Coder for air-gapped environments.

## Changes

- **`docs/admin/licensing/index.md`**: Added an "Offline license
validation" section explaining that license keys are signed JWTs
validated locally with no phone-home requirement.
- **`docs/install/airgap.md`**: Added a "License validation" row to the
air-gapped comparison table, confirming no changes are needed for
offline license validation and linking to the licensing docs.

## Why

While the air-gapped docs state that "all Coder features are supported"
offline, there was no explicit mention that the license itself doesn't
require connectivity. This is a frequent question from
security-conscious and air-gapped customers.

---------

Co-authored-by: blink-so[bot] <211532188+blink-so[bot]@users.noreply.github.com>
Co-authored-by: Matyas Danter <mdanter@gmail.com>
2026-04-06 20:43:49 +02:00

82 lines
2.5 KiB
Markdown

# Licensing
Some features are only accessible with a Premium license or the [AI Governance Add-On](../../ai-coder/ai-governance.md). See our
[pricing page](https://coder.com/pricing) for more details. To try paid
features, you can [request a trial](https://coder.com/trial) or
[contact sales](https://coder.com/contact).
![Licenses screen shows license information and seat consumption](../../images/admin/licenses/licenses-screen.png)
## Offline license validation
Coder license keys are signed JWTs that are validated locally using cryptographic
signatures. No outbound connection to Coder's servers is required for license
validation. This means licenses work in
[air-gapped and offline deployments](../../install/airgap.md) without any
additional configuration.
## Adding your license key
There are two ways to add a license to a Coder deployment:
<div class="tabs">
### Coder UI
1. With an `Owner` account, go to **Admin settings** > **Deployment**.
1. Select **Licenses** from the sidebar, then **Add a license**:
![Add a license from the licenses screen](../../images/admin/licenses/licenses-nolicense.png)
1. On the **Add a license** screen, drag your `.jwt` license file into the
**Upload Your License** section, or paste your license in the
**Paste Your License** text box, then select **Upload License**:
![Add a license screen](../../images/admin/licenses/add-license-ui.png)
### Coder CLI
1. Ensure you have the [Coder CLI](../../install/cli.md) installed.
1. Save your license key to disk and make note of the path.
1. Open a terminal.
1. Log in to your Coder deployment:
```shell
coder login <access url>
```
1. Run `coder licenses add`:
- For a `.jwt` license file:
```shell
coder licenses add -f <path to your license key>
```
- For a text string:
```sh
coder licenses add -l 1f5...765
```
</div>
## FAQ
### Find your deployment ID
You'll need your deployment ID to request a trial or license key.
From your Coder dashboard, select your user avatar, then select the **Copy to
clipboard** icon at the bottom:
![Copy the deployment ID from the bottom of the user avatar dropdown](../../images/admin/deployment-id-copy-clipboard.png)
### How we calculate license seat consumption
Licenses are consumed based on the status of user accounts.
Only users who have been active in the last 90 days consume license seats.
Consult the [user status documentation](../users/index.md#user-status) for more information about active, dormant, and suspended user statuses.