Debugging Overview
Real problems hit while building and deploying Ranlanka CRM, and the exact fixes applied — organized by area so the pattern is reusable even if the specific symptom looks slightly different next time.
Local DevelopmentCSRF & Auth ErrorsDeployment & DockerNetworking & FirewallsMonitoring & LogsDatabase BackupsCloudflare Pages Deployment Setup
Quick symptom lookup
| Symptom | Check this first |
|---|---|
| Bare 403 on login or mutating requests | CSRF & Auth Errors |
| Cloudflare-style “origin unreachable” error | Networking & Firewalls |
| Cloudflare-style “bad gateway” error | Deployment & Docker — container likely isn’t running |
| Container stuck restarting, stats show all-zeros | Deployment & Docker — architecture mismatch |
Permission denied on Docker commands | Deployment & Docker |
| Local Maven build fails with a file-lock error | Local Development |
| Not sure if the app is actually healthy | Monitoring & Logs |
| Logs not showing up in your log aggregator | Monitoring & Logs |
| Backups not appearing where expected | Database Backups |
| Currency conversion / quote-invoice generation 500s | Local Development — missing exchange-rate API key |
| Cloudflare Pages deploy fails or secrets are missing | Cloudflare Pages Deployment Setup |
Last updated on