Error fix
How to fix “503 Service Unavailable”
The server is temporarily unable to serve traffic—overload, maintenance, or dependency outage.
Updated Apr 20, 2026
Tools that help with this
Fastest fix
Start here first. Step 1 fixes most cases—then work down the list.
- Check CPU/memory, queue depth, and error rates in your platform dashboard.
- Scale out or shed load (queue, cache, circuit breakers).
- Return Retry-After when appropriate so clients back off.
Why this works
These steps work because it clears stale cached state that can cause the same request to fail repeatedly.
What this means
503 tells clients the service exists but cannot handle the request right now. Retry-After may hint when to try again.
Common causes
Capacity limits
Rate limits, connection saturation, or autoscaling lag under load.
Maintenance
Planned downtime or feature flags blocking requests.
Step-by-step fix
Restore capacity
- Check CPU/memory, queue depth, and error rates in your platform dashboard.
- Scale out or shed load (queue, cache, circuit breakers).
- Return Retry-After when appropriate so clients back off.
Related
Also see: 503 — browse the HTTP status hub.
FAQ
- 503 during traffic spikes?
- Add caching, autoscaling rules, and protect origins with a queue or WAF.
- Should search engines index 503 pages?
- Usually no—use temporary 503 with Retry-After for real outages; avoid soft-404 content.
- 503 from API gateway?
- Check throttling quotas and burst limits in the gateway configuration.
Fix related issues
Still stuck? Try these related fixes next.
- Kubernetes CrashLoopBackOffThe container exits repeatedly—check logs, probes, and resource limits.
- Heroku H10 — app crashedThe web process exited; Heroku serves an error page. Logs show the real exception.
- Netlify — page not foundThe deploy exists but no asset matches the path—often SPA routing or a missing file in publish dir.
- Vercel — deployment not foundThe deployment URL or project alias does not exist or was removed.
- Cloudflare 525 — SSL handshake failedCloudflare could not complete TLS with your origin—cert mismatch, wrong port, or TLS version.
Edit your error
Tweak the message and run again—we'll match an existing fix or generate a new page.
Original error message
503 Service Unavailable
