Skip to content
SHC Docs

shc label set

set a label value’s description, reservation or backup repo

Set a label value’s own properties. This never adds the label to a node; that is shc node label <node> <key>=<value>. --reserved applies to operator labels, location, cloud and control-plane: bare it is open to any tenant, with tenants only they may name the value in a constraint. --backup-repo applies to a location value only, and an empty value clears it. --reserved=false clears the reservation.

shc label set <key>=<value> [flags]
shc label set control-plane --reserved
shc label set tier=gpu --reserved acme,beta
shc label set location=hetzner/hel1 --backup-repo s3://bk-hel1
shc label set tier=gpu --reserved=false
--backup-repo string the off-site backup repo of a location value; empty clears it
--description string what the label value is for
-h, --help help for set
--reserved tenants[=true] keep work off its nodes unless a constraint names the label value; =<tenant>[,<tenant>] grants those tenants alone, =false clears it
--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)