Skip to content
SHC Docs

shc license install

install a vendor-signed licence token

Install a vendor-signed licence token on this estate: the fallback carrier.

The primary carrier is the estate’s own DNS: publish the vendor’s token as a TXT record at _shc-license. and the estate licenses itself with nothing to run here; shc license status shows the exact record name. Use this verb when the zone cannot carry it: a domain you do not control, a lab name, a bring-up before DNS exists, or an unbound fleet licence.

The token is the same value either way. Pass it as a bare argument, as a path to a file containing it, or as - to read stdin. The daemon verifies the Ed25519 signature against the embedded vendor key and the domain binding, stores it, and re-resolves entitlements. An estate holding both an installed token and a licence record runs the stronger of the two: later expiry wins, then the later mint.

shc license install <token|file|-> [flags]
-h, --help help for install
--config stringArray extra YAML config file to layer on top of auto-discovered config; repeatable, later files win
-d, --debug enable debug mode (default: $SHC_DEBUG)
-e, --environment string environment name (default: "prod", or "default" on an estate with no licence and no trial; $SHC_ENVIRONMENT and shc ctx -e override it, and the "master" tenant is always "default")
--exclude string comma-separated dotted paths to drop
--fields string comma-separated columns/keys to show (and their order)
--filter string comma-separated dotted paths to keep (drops everything else)
-o, --output string output format: tty|text|json|yaml (default: $SHC_OUTPUT)
-s, --stack string stack name (default: $SHC_STACK)
-t, --tenant string tenant name (default: $SHC_TENANT)
-v, --verbose verbose output (default: $SHC_VERBOSE)