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.
$ shc license statusstate: 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:03Zcapacity 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.
$ shc license trial start30-day trial started: Hobby tier.ends: 2026-12-06T17:09:57Z, when Hobby growth stops; everything you built keeps runninglocks: 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 statusstate: trialtrial 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:03ZInstall the Pro licence file. The daemon verifies its signature and the domain it is bound to, stores it and resolves the entitlements again.
$ shc license install ~/shc-license.tokenlicence installedstate: keyedtier: proholder: Learn walksource: filefeatures: 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:03Zauto-check: onfeatures 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.
$ shc license refreshshc: [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 fileA licence can be moved to another estate. delink drops the local copy;
the cluster falls back to the trial it started.
$ shc license delinklicense delinkedstate: trial$ shc license statusstate: trialtrial 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.tokenlicence installedstate: keyedtier: proholder: Learn walksource: filefeatures: 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:03Zauto-check: onlast check: 2026-11-06T17:09:59Z, the broker did not answer, 1 failed attempt X502962LICRFRThe 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:
$ shc license install -The group verbs alone print their usage: shc license lists the licence
verbs and shc license trial the trial’s.
$ shc license$ shc license trialNext: Joining nodes.