1ctl doctor

1ctl doctor runs diagnostics on authentication, backend reachability, zones, clusters, and live deployments. It helps identify configuration or connectivity issues.

Usage

1ctl doctor

Flags

Flag	Type	Required	Default	Description
--deployment-id, -d	string	No	—	Check one deployment instead of the whole namespace
--app	string	No	—	App name to resolve (alternative to –deployment-id)
--config	string	No	—	Config name or path (e.g. staging, satusky.staging.toml). Used to resolve a deployment ID when not provided.
--health-path	string	No	—	Explicit HTTP path for app-level smoke success (default: tries /health then /). Enforces 2xx/3xx success.
--smoke	boolean	No	false	Run smoke checks across all namespace deployments (opt-in for namespace-wide doctor)
--help, -h	boolean	No	—	Show help

Examples

# Run a full diagnostic
1ctl doctor

# Check a specific deployment
1ctl doctor --deployment-id dep_abc123

# Run smoke tests across the namespace
1ctl doctor --smoke

# Check a deployment with a custom health path
1ctl doctor --deployment-id dep_abc123 --health-path /api/health