Files
coder/docs/admin/licensing/index.md
T
Matt Vollmer 4987afada7 docs: present AI Governance as included with Premium (#27545)
## Summary

AI Governance is now included with Premium licenses instead of being
sold as a separate per-user add-on. This updates `docs/` to describe the
new packaging, removes "Add-On" from AI Governance references, and
refreshes the editions architecture diagram.

## Changes

- **`docs/ai-coder/ai-governance.md`**: title is now "AI Governance";
rewrote the licensing statements (previously "a separate, per-user
license... not included with a Premium subscription and must be
purchased separately") to state it is included with Premium. The
usage-pool section now attributes the shared Agent Workspace Build pool
to Premium deployments.
- **Repeated admonition (28 files under `ai-coder/agent-firewall/` and
`ai-coder/ai-gateway/`)**: replaced "requires the AI Governance Add-On /
as of Coder v2.32, deployments without the add-on..." with "is part of
AI Governance, which is included with a Premium license." The v2.32
add-on gate no longer applies; the gate is now Premium vs. Community.
- **`docs/ai-coder/index.md`, `security.md`, `tasks.md`,
`usage-data-reporting.md`, `admin/licensing/index.md`,
`install/releases/esr-2.29-2.34-upgrade.md`,
`ai-gateway/ai-gateway-proxy/setup.md`,
`ai-gateway/clients/claude-code.md`**: reworded add-on references to
Premium inclusion.
- **`docs/manifest.json`**: nav title "AI Governance Add-On" → "AI
Governance", updated two descriptions, and swapped the 25 `"state": ["ai
governance add-on"]` badges to `["premium"]` so the sidebar badge reads
"Premium" instead of "AI Governance Add-On".
- **`docs/images/single-region-architecture.png`**: refreshed the
diagram in the **Community and Premium editions** tab on
[Architecture](https://coder.com/docs/admin/infrastructure/architecture).
Also deleted the unreferenced `single-region-architecture.svg` copy.

## Follow-ups outside this PR

- The `"ai governance add-on"` doc-state badge is defined in
`coder/coder.com` (`src/utils/docs/state.ts`). After this merges, no
manifest entry uses that key, so it becomes dead config and can be
removed there.
- `enterprise/coderd/license/license.go:564-572` still warns admins that
"The AI Governance add-on is required to use AI Gateway." That backend
string will contradict these docs once shipped.

## Verification

- `pnpm run lint-docs`: 0 errors across 504 files
- `make lint/emdash`: clean
- Vale on the changed Markdown files: 0 errors; remaining warnings are
pre-existing gerund headings on untouched lines
- `docs/manifest.json` validated as JSON
- Confirmed the deleted SVG had no references anywhere in the repo

---

PR generated with Coder Agents on behalf of @mattvollmer.
2026-07-29 08:45:20 -04:00

83 lines
2.5 KiB
Markdown

# Licensing
Some features are only accessible with a Premium license, including
[AI Governance](../../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:
```sh
coder login <access url>
```
1. Run `coder licenses add`:
- For a `.jwt` license file:
```sh
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.