Skip to main content
A self-managed control plane runs on a license issued by Skyhook. This page is what you do with it.

Install a license

Get the license:
  • Cloud-managed deployment: generate it in Radar Cloud under Settings → Self-Managed. It renews itself once a day from there.
  • Air-gapped deployment: ask us. It is issued by hand with the cluster count in your contract, and it carries the permission for hub.airGapped=true.
Supply it to the chart in one of two ways:
The control plane starts without a license, but the console shows a license screen until one is installed.

Replace a license

If the license is in your values, upgrade with the new value. The upgrade restarts the hub for you:
If it is in your own Secret, update the Secret, then restart the hub so it reads the new file:
Nothing is interrupted while you do this. Your clusters, the agents and the API keep working throughout. A cloud-managed deployment does not need this for renewal. It fetches a fresh license every day on its own.

If a license key leaks

Contact support and ask for the key to be rotated. The leaked key stops renewing from that moment and expires on its own schedule. Install the replacement as above.

When a license lapses

The control plane keeps working in full for a grace period. When the grace period ends, the web console closes for everyone until a valid license is installed. Not affected at any point: your clusters and their data, the agents, the tunnel, personal access tokens and the API. Break-glass sign-in still works, but it does not reopen the console. To recover, install a valid license as above. This needs access to the Helm release or the Secret. There is no way to do it from the console.

Air-gapped

Set hub.airGapped=true. The control plane then makes no outbound calls of its own: no license renewal and no check for Radar releases. Anything you configure yourself, such as an identity provider or an AI model provider, still connects where you point it. It needs a license that permits it. With any other license the control plane refuses to start and says why. To install without internet access, see Air-gapped install. An air-gapped license carries a cluster count. Clusters already connected keep working; connecting one beyond that count is refused, and the refusal names both numbers. To run more, ask us for a new license and install it as above.

Billing

Clusters on a self-managed control plane are billed through your Radar Cloud organization. See Billing.