Skip to content
SHC Docs

shc cluster leave

leave the cluster

Leave this node from the cluster. Refuses while deployments still run here: drain or move them first with shc node drain <node>, or pass --force to leave anyway and strand them. Then migrates NFS / ceph state and removes the node from raft membership. Stops this node’s member subsystems and moves certs, node.id, cluster_join.json, node_bootstrap.json, rqlite, shc.db and its journals, mesh, fabric, engine.json, rqlite_promote_pending, .force-rejoin, vault-envelope-identity, system-apps.initialized, leave-pending.json into a dated left-cluster directory under the state home. The output names that directory. Keeps images, deployment files and deployment volumes. The node can then join again. A node that leaves comes back active when it joins again; a drain does not outlive the leave.

When this node is a voter and leaving takes the cluster below its voter target, the leave warns and proceeds, naming the before/after voter count, the target and the fault tolerance it costs. The suffrage pass then promotes a non-voter inside the control-plane fence.

shc cluster leave [flags]
-f, --force leave even when deployments still run on this node
-h, --help help for leave
-y, --yes skip confirmation prompt
--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)