Skip to content
SHC Docs

shc cluster block add

add an address block to the cluster

Record one more IPv4 block, a /8 to a /26, as a pool of /26 chunks for node fabric addresses, service VIPs and mesh addresses, and /25s for an Incus cluster’s deployment networks. It is refused when it shares an address with the genesis block, a block already added, the docker address pool, or a network or route on any node of the cluster, and the refusal names the overlap. Every node is asked for its networks, so the add is refused while a node cannot be reached.

A docker or podman node’s fabric network holds every block, so each such node recreates it, one node at a time, and the containers on it restart there and come back at their own addresses. The add prints each node’s progress and returns once every node holds the block, or after 30 minutes while one still takes it; a node that is down takes it when its daemon is back.

A block is never removed or shrunk: pick one no site LAN, VPN or cloud network will want.

shc cluster block add <cidr> [flags]
-h, --help help for add
-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)