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.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.
Activate on first install
The license key is pasted into the Helm values block during install. See Install Foggy 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
- Reach out to your founder-team contact (Slack Connect channel if you have one).
- Foggy issues a new license JWT for your workspace.
- In the Console, go to Settings → License → Replace Key.
- Paste the new JWT and save. The banner disappears on next page load.
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
Install Foggy
Full install walkthrough.
Upgrades
Apply new Foggy releases.