Skip to content
SHC Docs

The licence

A fresh cluster is unlicensed. It runs, and every paid feature refuses until a licence is installed. Clustering is one of them, so the licence comes before the joins.

home01
$ shc license status
state: unlicensed
capacity:
now: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0
term peak: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0
term began: 2026-11-06T17:07:03Z

capacity counts what the cluster uses now and the most it used in the current term. A licence is checked against those figures.

The trial is an opt-in: it lends the Hobby tier for thirty days on one node. Start it and read what changed.

home01
$ shc license trial start
30-day trial started: Hobby tier.
ends: 2026-12-06T17:09:57Z, when Hobby growth stops; everything you built keeps running
locks: 2026-12-20T17:09:57Z, after the 14-day grace period. Every estate change is then refused:
installs, updates, config and cluster changes, and backup create/restore.
No container is ever stopped and existing backups stay downloadable.
An estate that never starts a trial is never locked. Activate a license
before then to clear it; `shc license status` shows where you stand.
$ shc license status
state: trial
trial ends: 2026-12-06T17:09:57Z
capacity:
licensed: max_nodes=1
now: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0
term peak: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0
term began: 2026-11-06T17:07:03Z

Install the Pro licence file. The daemon verifies its signature and the domain it is bound to, stores it and resolves the entitlements again.

home01
$ shc license install ~/shc-license.token
licence installed
state: keyed
tier: pro
holder: Learn walk
source: file
features: audit, branding, clustering, console, container_runtime, environments, fleet, marketplace, mcp, multi_provider, quota, rbac, sso, support_bundle, tenancy
capacity:
licensed: max_nodes=10
now: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0
term peak: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0
term began: 2026-11-06T17:07:03Z
auto-check: on

features lists what the tier covers; clustering is what the next page needs. licensed is the ceiling, max_nodes=10 here. auto-check: on means the daemon asks the licence broker every few hours whether a newer licence applies. Ask now instead of waiting.

home01
$ shc license refresh
shc: [X502962LICRFR] license re-fetch from the broker failed, estate serving domain is empty because SHC_HOST is unset, entitlements continue resolving from the locally held file

A licence can be moved to another estate. delink drops the local copy; the cluster falls back to the trial it started.

home01
$ shc license delink
license delinked
state: trial
$ shc license status
state: trial
trial ends: 2026-12-06T17:09:57Z
capacity:
licensed: max_nodes=1
now: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0
term peak: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0
term began: 2026-11-06T17:07:03Z
$ shc license install ~/shc-license.token
licence installed
state: keyed
tier: pro
holder: Learn walk
source: file
features: audit, branding, clustering, console, container_runtime, environments, fleet, marketplace, mcp, multi_provider, quota, rbac, sso, support_bundle, tenancy
capacity:
licensed: max_nodes=10
now: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0
term peak: max_nodes=1 max_cores=2 max_seats=0 max_tenants=0
term began: 2026-11-06T17:07:03Z
auto-check: on
last check: 2026-11-06T17:09:59Z, the broker did not answer, 1 failed attempt X502962LICRFR

The cluster is keyed again. shc license status is where expiry shows: a keyed estate prints expires under state, and a lapsed one reads degraded.

Publish the vendor-signed token in the licence record that shc license status names. When DNS cannot carry it, install the same token from a file with shc license install <file> or from stdin:

explained, not walked: needs a vendor-signed token
$ shc license install -

The group verbs alone print their usage: shc license lists the licence verbs and shc license trial the trial’s.

explained, not walked: the group verb alone prints its usage
$ shc license
$ shc license trial

Next: Joining nodes.