Skip to content
SHC Docs

shc inspect

Dump a stack’s files + runtime snapshot in one call.

shc inspect <stack> calls GET /api/method/shc.stack.inspect and renders the response — both the file bundle (rendered compose, vars, plugs/sockets, jobs, the persisted state JSON, the backup manifest) and a runtime snapshot:

  • composed_config — parsed docker compose config --format json output (best-effort, omitted if compose can’t resolve).
  • containers — every container under the compose project label with state, status, image, and a Health field enriched from the metrics stats cache.
  • health_rollup — healthy / starting / unhealthy / unknown summary of the container set, same precedence as the HUD Stack panel.
  • created_at / updated_at / status_changed_at — timestamps from the deployment row. status_changed_at bumps only on a real status flip via Service.UpdateStatus.

For long-running stacks the runtime snapshot is the same one the HUD Stack panel renders, so an operator can do a one-shot CLI inspect without spinning up the TUI.