[ Troubleshooting ]
Troubleshooting
Fast answers for launch-window and production issues. Start with the matching symptom below, apply the fix, then re-run route and event checks before moving to escalation.
Docs route returns 404 in production
Symptom: Site root works but /docs is missing after merge.
Fix: Redeploy the latest build and verify that the /docs route is published.
No events in dashboard
Symptom: Plugin is active but event stream is empty for hours.
Fix: Verify badger_honeypot_enabled is true and ensure caching/CDN rules do not bypass trap paths.
Login lockouts are too aggressive
Symptom: Legitimate editors get locked out during normal workflows.
Fix: Increase badger_login_max_attempts or reduce lockout duration incrementally.
Unexpected crawler blocks
Symptom: Legitimate integrations are denied after enablement.
Fix: Disable badger_block_all_unknown, then rebuild allow/block list from observed telemetry.
Rate limiting has no effect
Symptom: Traffic exceeds threshold but responses are unchanged.
Fix: Set badger_rate_limit_enabled true and verify your stack is not terminating requests upstream.
Escalation checklist
- Capture plugin version and WordPress version.
- Include the affected URL, HTTP status code, and a screenshot.
- List recent Badger configuration changes.
- Email support with these details for escalation.
Contact support.