Skip to content

5xx Server errors

503 Service Unavailable

The server is temporarily unable to handle the request: maintenance mode or overload.

Common causes

  • php artisan down (maintenance mode) still on after a deploy.
  • The server is overloaded or out of resources.

How to fix a 503 error

  1. 1

    Run php artisan up, or delete storage/framework/down.

  2. 2

    Check the server's CPU, memory and process limits; on shared hosting, cPanel → Resource Usage.

Fix Laravel errors on shared hosting Laravel log analyzer Search error fixes for 503

In Laravel

php artisan down --secret="…" lets you open the site yourself while visitors see the 503 page.

Check the status of a URL

The first line of the response shows the status code; -L follows redirects and shows each step.

curl -I https://example.com/page
curl -IL https://example.com/old-page

Frequently asked questions

What does HTTP 503 mean?

The server is temporarily unable to handle the request: maintenance mode or overload.

How do I fix a 503 error?

Run php artisan up, or delete storage/framework/down. Check the server's CPU, memory and process limits; on shared hosting, cPanel → Resource Usage.

How does Laravel handle 503?

php artisan down --secret="…" lets you open the site yourself while visitors see the 503 page.

Popular tags

#API #awk #Database #DevOps #Eloquent #Laravel #Linux #MySQL #Performance #PHP

Type to search. Press Enter for all results.

Get new articles in your inbox

Practical tutorials and deep dives, about once a week. No spam, unsubscribe anytime.

Privacy policy

Add DEV Talk to your Home Screen

  1. 1 Tap the Share button in Safari's toolbar.
  2. 2 Scroll down and tap Add to Home Screen.
  3. 3 Tap Add. Open it from the Home Screen to read like an app and to turn on notifications with the bell.

We use cookies to improve your experience and analyze traffic. By continuing, you agree to our Privacy Policy.