Skip to content
SHC Docs

shc status

show deployment and service health

Show the health of the deployments: a fleet node table, one row per deployment, and a summary.

Named with a stack, the answer is about that deployment: its replicas and its groups, each member with the group service selector it backs. If it has no health data the reason is named rather than silently omitted. Use shc ls for the deployment inventory and shc cluster status for raft / quorum posture.

Scope. -a covers every tenant, the same estate-wide answer shc ls --all-tenants gives; name a tenant with -t/--tenant to narrow it, and read the TENANT column to see which tenant a row is in. --all-tenants lifts a tenant named in $SHC_TENANT or shc ctx -t. Naming a stack instead resolves it in your own tenant, as shc install and shc vault do.

shc status [stack] [flags]
-a, --all show all deployments; every tenant unless -t/--tenant names one
--all-tenants show every tenant's deployments (platform admins; others see their own tenant)
-h, --help help for status
--resources add a table of live CPU and memory per deployment (measured, not the quota reservation)
--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)
  • shc - Selfhosted Cloud CLI