> ## Documentation Index
> Fetch the complete documentation index at: https://docs.foggyhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# License

> Activate, renew, and rotate your Foggy self-hosted license.

Foggy self-hosted is gated by a signed license key (Ed25519 JWT). The key is verified locally — Foggy never calls home — and lives in your cluster as a Kubernetes Secret.

## Activate on first install

The license key is pasted into the Helm values block during install. See [Install Foggy](/self-hosted/getting-started) for the full sequence.

Foggy issues a **30-day trial** license by default. Contact your founder-team channel to request a longer term when you're ready to extend.

## Expiry banner

Starting 7 days before expiry, a banner appears at the top of every Console page. Non-admin users are told to contact their admin; admins see a direct "Renew" pointer.

## Renew

1. Reach out to your founder-team contact (Slack Connect channel if you have one).
2. Foggy issues a new license JWT for your workspace.
3. In the Console, go to **Settings** → **License** → **Replace Key**.
4. Paste the new JWT and save. The banner disappears on next page load.

The new key can be pasted before the old one expires — no gap.

## Rotation of the signing key

Foggy's own signing key can be rotated (vendor side) without any action on your end. The Foggy container ships with every trusted public key version; as long as you keep current with upgrades, a rotated license validates on arrival.

## Troubleshooting

* **"Invalid license" on startup** — the JWT is malformed or signed with a key this Foggy version doesn't trust. Confirm you pasted the full JWT (starts with `ey...`) and that your Foggy image version is recent enough to include the signing key used to issue your license.
* **Banner still visible after paste** — reload the page. The banner state is cached in the browser for one page load.
* **License expired in production** — Foggy continues serving existing investigations but blocks new connector saves and new investigations. Paste a renewed JWT to unblock.

## Next steps

<CardGroup cols={2}>
  <Card title="Install Foggy" icon="server" href="/self-hosted/getting-started">
    Full install walkthrough.
  </Card>

  <Card title="Upgrades" icon="arrow-up-right-from-square" href="/self-hosted/upgrades">
    Apply new Foggy releases.
  </Card>
</CardGroup>
