Overview

This section is the troubleshooting tree. Pages are organized by observed symptom (or by error code, when one is emitted) rather than by service, because the user knows what they see, not what's wrong.

By symptom

• podman compose up fails
• Login loops
• Consent screen shows for every request
• Email not sending
• Locked out of admin
• pgAdmin SSO fails
• Cookies not persisting cross-port

By error

• encryption_key_not_set startup failure
• Certificate expired
• Database SSL mismatch
• Reload API key invalid
• redirect_uri localhost in prod
• OAuth2 invalid_grant
• OAuth2 pkce_required
• Kratos flow expired
• Kratos CSRF violation
• Kratos session AAL too low

Status

This section is built out in Phase 8 of the documentation plan. The errors are emitted by the running containers today; the trouble pages are filled in as we encounter and document each one.