mirror of
https://github.com/coder/coder.git
synced 2026-06-04 21:48:22 +00:00
d2950e7615
## 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>
82 lines
2.5 KiB
Markdown
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).
|
|
|
|

|
|
|
|
## 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**:
|
|
|
|

|
|
|
|
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**:
|
|
|
|

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

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