Files
coder/docs/admin/licensing/index.md
T
Ben Potter ece531ab4e chore: mention usage data reporting in AI Gov docs (#21664)
<!--

If you have used AI to produce some or all of this PR, please ensure you
have read our [AI Contribution
guidelines](https://coder.com/docs/about/contributing/AI_CONTRIBUTING)
before submitting.

-->
2026-01-23 21:40:17 +00:00

74 lines
2.2 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)
## 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.