mirror of https://github.com/coder/coder.git synced 2026-06-02 20:48:20 +00:00

Files

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

2.5 KiB

Raw Permalink Blame History

Licensing

Some features are only accessible with a Premium license or the AI Governance Add-On. See our pricing page for more details. To try paid features, you can request a trial or contact sales.

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 without any additional configuration.

Adding your license key

There are two ways to add a license to a Coder deployment:

Coder UI

With an Owner account, go to Admin settings > Deployment.
Select Licenses from the sidebar, then Add a license:
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:

Coder CLI

Ensure you have the Coder CLI installed.
Save your license key to disk and make note of the path.
Open a terminal.
Log in to your Coder deployment:
```
coder login <access url>
```

Run coder licenses add:

For a .jwt license file:

coder licenses add -f <path to your license key>

For a text string:
```
coder licenses add -l 1f5...765
```

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:

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 for more information about active, dormant, and suspended user statuses.

2.5 KiB Raw Permalink Blame History