Troubleshooting

Three layers:

1. Error codes — every E* / boundary / quota code the runtime emits.
2. Runbook index — every runbook_url from the shipped Prometheus alert rules.
3. Flowcharts — scoped to the two high-value first-week questions:
   • "My install failed" (below).
   • "My declaragent deploy got 403".

My install failed

If none of those branches match, open an issue with the full installer output.

Logging

Every runbook expects DECLARAGENT_LOG_LEVEL=debug when reproducing an issue:

DECLARAGENT_LOG_LEVEL=debug declaragent daemon

Still stuck?

• Open a discussion at github.com/declaragent/declaragent/discussions.
• File an issue at github.com/declaragent/declaragent/issues — include declaragent --version, the full command, the full output, and your OS + arch.