shc cluster host set
shc cluster host set
Section titled “shc cluster host set”change the cluster’s serving domain on a live cluster
Synopsis
Section titled “Synopsis”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]Options
Section titled “Options” --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 promptOptions inherited from parent commands
Section titled “Options inherited from parent commands” --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)SEE ALSO
Section titled “SEE ALSO”- shc cluster host - show or change the cluster’s serving domain