Skip to content
SHC Docs

shc doctor origin-probe

detect an app that advertises a persisted origin instead of the request host

Fetch one surface of a running deployment under several different Host values and classify every absolute origin it emits back.

An origin that tracks the request host is derived and a host move fixes it for free. An origin that is identical under every probe host is a pin, and the report separates the two kinds that matter: a rendered-pin is present in the deployment’s rendered configuration and shc update re-points it, while a seed-once origin appears nowhere in the render and is therefore persisted in the app’s own state, and no re-render reaches it. Constant origins that are not identities of this deployment (CDNs, project links) are reported as foreign and are not faults.

Run this before an import or a host flip. Exits non-zero when a seed-once origin is found.

shc doctor origin-probe <stack> [flags]
--edge probe through this node's own ingress over https instead of inside the container's network namespace; needed for an app that force-redirects plain http, and limited to hosts the edge actually routes
-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")
-h, --help help for origin-probe
--host-header strings Host header value to probe with, repeatable; at least two different values are needed (default: the deployment's routed hosts)
--path string path to fetch (default: the seed_once probe_path, else /)
--service string service to probe (default: the seed_once probe_service, else the deployment's routed service)
-t, --tenant string tenant owning the deployment
--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)
--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)
-v, --verbose verbose output (default: $SHC_VERBOSE)