debug

Use debug to capture a snapshot of the active context’s state when reporting an issue or diagnosing unexpected behaviour. The bundle prints to stdout by default. Pipe it to a file or use --output to save it directly. The core bundle includes an ingress section built from the same route and port resolver used by sitectl stats. This shows the primary URL, plugin-declared secondary routes, trusted proxy settings, and whether Traefik’s HTTP/HTTPS host ports are running or would be published on the next start.

Reference

Collect a diagnostic bundle for the active context and print it to stdout. The bundle includes: host resource summary, Compose service status, container log driver configuration, Docker image inventory, and plugin-specific diagnostics contributed by the context’s plugin. Use --output to write the bundle to a file instead of printing to stdout.

sitectl debug

Flag	Default	Description
`-o, --output`		Write the bundle to a file instead of stdout.
`-v, --verbose`	`false`	Include additional diagnostic details.

# Save to a file
sitectl debug --output debug-bundle.txt

# Capture stdout directly
sitectl debug > debug-bundle.txt

Plugin diagnostics are included automatically, so the bundle captures stack-specific state without any extra flags.

Getting started

Concepts

Commands

Reference

​Reference

​Sharing a bundle

Reference

Sharing a bundle