shc init
initialize a new cluster
Reference for the init command (module modules/cluster). Source: modules/cluster/commands/init.go.
This is a single-action command (no subcommands). Init is pure
bootstrap: CA + node cert, runtime detection, daemon start,
vault unlock, then the system-app install pass. Provider/LB/connection
setup happens post-init (shc connection …).
Read before you run it. Init-time decisions classifies everything this command fixes: what is genuinely irreversible, what only looks that way because no verb exists, and what an estate gets by default because nobody chose it. The expensive ones are
--ingress-host,--nameand--address-block, plus the backup repository password, which this command does not take a flag for.
| Flag | Type | Required | Help |
|---|---|---|---|
--name / -n | str | no | node name |
--runtime / -r | str | no | container runtime (docker, podman, incus, or apple). swarm is refused (X400422CLSRUN) |
--nic | str | no | network interface for all cluster-internal traffic (raft, internal API, mesh0 underlay). Blank = auto-detect (private-preferred) |
--acme-provider | str | no | name of a named ACME provider to define + set as the cluster default (acme.providers.<name> + acme.default) |
--acme-directory | str | no | ACME directory URL for --acme-provider (blank = Let’s Encrypt production; e.g. the LE staging URL) |
--acme-email | str | no | ACME contact email (the global acme.email fallback contact) |
--ingress-host | str | no | public host where Traefik fronts SHC’s apps |
--modules-config | str | no | system-app selection + per-app overrides as a compact JSON object keyed by app name, e.g. '{"keycloak":{"host":"auth.example.com"},"traefik":{}}'. The key set is the install selection (traefik is always installed with the selection because nodes join through it on 443, so {} installs traefik alone); each value seeds modules.<name>.{host,base_path,vars.*} before the install pass. Unset falls back to the daemon’s SHC_MODULES default set. |
--public-address | str | no | public IP or stable public hostname internet traffic reaches this node at (recorded on the node row; managed DNS for internet exposure reads it) |
--yes / -y | bool | no | skip confirmation prompt |
--vault-password | str | no | set the vault master password non-interactively |
--vault-password-file | str | no | read the vault master password from a file (mode 0600 expected); use - to read from stdin. Takes precedence over --vault-password and SHC_VAULT_PASSWORD |
--force / -f | bool | no | wipe local cluster state and re-initialize even if this node is already clustered |
shc@docs:~$