Troubleshooting¶

Console¶

Symptom	Likely cause	What to do
Redirect to Dashboard	Plan or role blocks route	Check Console tour
403 on scan	Domain not verified	Complete DNS/HTTP proof
429 on scan	Daily quota	Wait for UTC reset or upgrade plan
Blank Reports	Scan failed or still running	Re-open scan status
SSE stops mid-scan	Proxy timeout	Increase reverse-proxy read timeout for `/pentest/scan-stream`

Symptom	Likely cause	What to do
Worker idle	Redis down	Restore Redis; check `REDIS_ENABLED`
`/health` ok but scans fail	Worker not running	`docker compose ps` worker
Playwright errors	Chromium missing	Rebuild image; check logs for `Playwright Chromium: OK`
Startup blocked	Invalid prod settings	Read startup error — license, CORS, WS auth

Code	Meaning
401	Missing/expired JWT or API key
403	Role, plan, or target policy
404	Wrong org scope or missing resource
422	Validation error — see body `detail`
429	Rate limit or scan quota

See Errors for versioning policy.