503 Service Unavailable

What HTTP 503 Service Unavailable Means

The server is currently unable to handle the request due to temporary overloading or maintenance.

Server temporarily unavailable.

Common Causes

• Server maintenance
• Server overloaded
• Too many connections
• Resource exhaustion
• Application restart

How to Fix It (For Visitors)

• Wait a few minutes and try again
• Check Retry-After header
• Visit status page

How to Fix It (For Developers/Admins)

• Check server resources (CPU, RAM, disk)
• Scale infrastructure
• Implement load balancing
• Set Retry-After header
• Check database connections
• Review application pool settings

Returning a 503 Service Unavailable (Code Examples)

If you build APIs or web apps, here is how to send an HTTP 503 response and how to test for it:

Node.js (Express)

app.get('/resource', (req, res) => {
  res.status(503).json({ error: 'Service Unavailable' });
});

Python (Flask)

@app.route('/resource')
def resource():
    return jsonify(error='Service Unavailable'), 503

PHP

<?php
http_response_code(503);
header('Content-Type: application/json');
echo json_encode(['error' => 'Service Unavailable']);

Check the status with curl

curl -I https://example.com/resource
# Look for: HTTP/1.1 503 Service Unavailable

Frequently Asked Questions

What does HTTP 503 Service Unavailable mean?

Server temporarily unavailable. In short: The server is currently unable to handle the request due to temporary overloading or maintenance.

Is a 503 Service Unavailable error my fault or the website's?

503 is a 5xx server-error code, so the problem is on the server side, not your browser or device. As a visitor you can usually only retry; if you run the site, investigate the server.

How do I fix a 503 Service Unavailable error?

Check server resources (CPU, RAM, disk). Scale infrastructure. Implement load balancing.

Official Specification

The 503 Service Unavailable status code is defined in RFC 7231 Section 6.6.4.

View the IANA HTTP Status Code Registry →