Skip to content
SHC Docs

shc license refresh

ask the license broker whether this estate’s plan changed

Ask the license broker whether a newer license applies to this estate, after a purchase, an upgrade, a renewal or an overage file, and install it if so.

The daemon already does this automatically every few hours, when there is something to ask about, so this is for when you do not want to wait. It changes nothing unless the broker hands over a newer license: entitlements always resolve from the local file, so a broker that is down or declining leaves this estate exactly as licensed as it was.

Airgapped estates, with license.offline set, never dial; use shc license install <file> with a vendor-signed file instead.

shc license refresh [flags]
-h, --help help for refresh
--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)