08 · Troubleshooting & FAQ

Fast fixes for the errors and edge cases that come up most. Each page leads with the exact symptom.

Common issues

• Can't sign in / lost API key - recover access via the in-container tools.
• GetFlightInfo failed: Invalid or expired token - the two causes behind failing eddytor query.
• Storage probe failures - authentication failed, not found, could not reach storage.
• OAuth redirect_uri mismatch - 400 redirect_uri does not match any registered URI.
• Stale discovery / metadata - why deletes behind Eddytor's back go stale.
• Reset a throwaway stack - start over on a local evaluation stack.

First-line triage

• CLI / auth / Flight issues → run eddytor doctor; it checks connectivity, auth, and the Flight SQL endpoint specifically.
• REST errors → capture the request_id from the error envelope for log correlation.
• Server won't boot → check the logs for secret decrypt failed (wrong EDDYTOR_ENCRYPTION_KEY) or a stuck Init (DB handshake) - see Upgrades.