Skip to content
SHC Docs

shc cluster mesh rotate

rotate a node’s mesh0 and shc0 keys

Rotate a node’s WireGuard keys: this node with no node named, a node by name or id. A device after the colon rotates only that one, mesh0 or shc0; with none, mesh0 rotates and then shc0. Each rotation is prepared, every ready node installs the new key beside the old, and the node switches; a peer loses at most one handshake. A Mac’s shc0 key does not rotate.

shc cluster mesh rotate [<node>][:<device>] [flags]
shc cluster mesh rotate
shc cluster mesh rotate n2
shc cluster mesh rotate n2:shc0
shc cluster mesh rotate :mesh0
-h, --help help for rotate
--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)