Document Utilities
Common Errors & Fixes
This page lists the most frequent DEQLYNK operational issues and their fastest corrective actions. Use it as a first-response runbook before escalating to developer support.
| Error | Symptom | Fix |
|---|---|---|
| Cloudflare Turnstile Failed | Login/queue challenge returns security failure even after completion. | Check .env keys for TURNSTILE_SITE_KEY and TURNSTILE_SECRET_KEY. Confirm keys match the active domain. |
| CORS Blocked | Browser console shows blocked cross-origin requests or credential errors. | Check app.py allowed origins logic and ensure your domain is included in approved origin checks. |
| Model Not Responding | Message is accepted but response appears stalled or missing. | Check queue and runtime status in Admin Dashboard; verify system mode is not maintenance/training and confirm model engine health. |
Fast Triage Checklist
- Verify service mode in owner dashboard.
- Inspect browser network tab for HTTP status patterns (403, 429, 503).
- Confirm session/login state before endpoint testing.
- Re-test from localhost with controlled environment variables.