Skip to content
SHC Docs

shc cluster host set

change the cluster’s serving domain on a live cluster

Move the estate to a new serving domain without a re-genesis. The value is written to the replicated cluster.host row and every host-derived surface re-derives from it on its own sweep. The command returns once the system Keycloak serves under the new host, its issuer pin and base path moved, so an auth call made next reaches it. The rest converges after it returns (Traefik’s system routes and their certificates, the auth service’s expected issuer, managed DNS, the otel endpoint).

What it costs. The estate’s OIDC issuer moves, so every live SSO session invalidates and every Keycloak-integrated deployment re-renders: the same bounded, loud invalidation a dedicated keycloak-host change already performs. Old-host bookmarks and cached DNS are covered by the grace window (--grace), during which the old host keeps its record and stays reachable; the record is released after it.

What it does not do. Tenant app hosts are their own values and are untouched. If they were subdomains of the old domain, each deployment needs its own shc update --expose.

shc cluster host set <host> [flags]
--grace duration how long the old host keeps its dns record and stays served after the flip (default 24h)
-h, --help help for set
-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)