Nginx
A web server that can also be used as a reverse proxy, load balancer, and HTTP cache.
Nginx powers a significant portion of the web ecosystem, but like any complex technology, it has its own unique set of challenges. When you encounter an error on this platform, it is rarely a random event. It is usually a specific response to a misconfiguration, a resource limit, or a compatibility issue. Our documentation for Nginx is designed to cut through the noise. We don't just list the error codes; we explain the architecture behind them, helping you understand why the platform is rejecting your request or failing to load.
Common Errors
ERR_TOO_MANY_REDIRECTS
The ERR_TOO_MANY_REDIRECTS error, also known as a redirect loop, occurs when the website keeps redir...
Not Found
The 404 Not Found error is the most recognizable HTTP status code. It indicates that the server was ...
Internal Server Error
The 500 Internal Server Error is a generic catch-all response indicating that the server encountered...
Bad Gateway
A 502 Bad Gateway error indicates that a server acting as a gateway or proxy received an invalid res...
403 Forbidden
The 403 Forbidden error indicates that the server understands the request but refuses to authorize i...
503 Service Unavailable
The 503 Service Unavailable error means the server is currently unable to handle the request due to ...
504 Gateway Timeout
The 504 Gateway Timeout error indicates that a server acting as a gateway or proxy did not receive a...
400 Bad Request
The 400 Bad Request error indicates that the server cannot or will not process the request due to so...
401 Unauthorized
The 401 Unauthorized error indicates that the request has not been applied because it lacks valid au...
405 Method Not Allowed
The 405 Method Not Allowed error indicates that the method received in the request-line is known by ...
429 Too Many Requests
The 429 Too Many Requests error indicates that the user has sent too many requests in a given amount...
ERR_SSL_PROTOCOL_ERROR
This error occurs when the browser cannot establish a secure connection to the server due to an issu...
Error 521 Web Server Is Down
This is a Cloudflare-specific error indicating that the origin web server refused the connection fro...
408 Request Timeout
The 408 Request Timeout error indicates that the server did not receive a complete request from the ...
505 HTTP Version Not Supported
The 505 HTTP Version Not Supported error indicates that the server does not support, or refuses to s...
Payload Too Large
The 413 Payload Too Large error indicates that the request entity is larger than limits defined by t...
Not Acceptable
The 406 Not Acceptable error occurs when a server is able to locate the requested resource but canno...
Unsupported Media Type
The 415 Unsupported Media Type error indicates that the server refuses to accept the request because...
Gone
The 410 Gone error is a permanent version of the 404 Not Found error. It indicates that the resource...
Web Server Returns an Unknown Error
Error 520 is a catch-all response from Cloudflare when the origin server returns something unexpecte...
URI Too Long
The 414 URI Too Long error indicates that the URL requested by the client is longer than the server ...
Length Required
The 411 Length Required error indicates that the server refuses to accept the request without a defi...
Precondition Failed
The 412 Precondition Failed error indicates that one or more conditions given in the request header ...
Range Not Satisfiable
The 416 Range Not Satisfiable error indicates that the server cannot serve the requested byte range ...
Expectation Failed
The 417 Expectation Failed error indicates that the server cannot meet the requirements of the Expec...
Not Implemented
The 501 Not Implemented error indicates that the server does not recognize the request method or lac...
SSL Handshake Failed
Error 525 indicates that the SSL handshake between Cloudflare and the origin web server failed. This...
Invalid SSL Certificate
Error 526 occurs when Cloudflare is set to 'Full (Strict)' SSL mode, but the origin server's SSL cer...
Unprocessable Entity
The 422 Unprocessable Entity error indicates that the server understands the content type of the req...
Conflict
The 409 Conflict error indicates that the request could not be completed due to a conflict with the ...
Insufficient Storage
The 507 Insufficient Storage error indicates that the server is unable to store the representation n...
Loop Detected
The 508 Loop Detected error indicates that the server terminated an operation because it encountered...
Proxy Authentication Required
The 407 Proxy Authentication Required error is similar to 401 Unauthorized, but it indicates that th...
Request Header Fields Too Large
The 431 Request Header Fields Too Large error indicates that the server is unwilling to process the ...
Bandwidth Limit Exceeded
The 509 Bandwidth Limit Exceeded error is a non-standard status code used by many shared hosting pro...
Network Authentication Required
The 511 Network Authentication Required error indicates that the client needs to authenticate to gai...
Locked
The 423 Locked error indicates that the resource that is being accessed is locked. This is a WebDAV-...
Failed Dependency
The 424 Failed Dependency error means that the request failed because it depended on another request...
Precondition Required
The 428 Precondition Required error indicates that the origin server requires the request to be cond...
Variant Also Negotiates
The 506 Variant Also Negotiates error indicates that the server has an internal configuration error:...
Not Extended
The 510 Not Extended error indicates that the policy for accessing the resource has not been met in ...
ERR_SSL_VERSION_OR_CIPHER_MISMATCH
This error happens when the browser and the server cannot agree on a common encryption protocol (SSL...
Unavailable For Legal Reasons
The 451 Unavailable For Legal Reasons error indicates that the server is denying access to the resou...
Misdirected Request
The 421 Misdirected Request error happens when a request is directed at a server that is not able to...
Upgrade Required
The 426 Upgrade Required error indicates that the server refuses to perform the request using the cu...
I'm a Teapot
The 418 I'm a Teapot error is an HTTP status code defined in RFC 2324 (Hyper Text Coffee Pot Control...
ERR_CONTENT_DECODING_FAILED
The ERR_CONTENT_DECODING_FAILED error occurs when the browser receives data from the server but cann...
ERR_SSL_OBSOLETE_VERSION
The ERR_SSL_OBSOLETE_VERSION error is a security warning in Chrome indicating that the website is us...
Nginx SSL Module Configuration Error
The `ngx_http_ssl_module` in Nginx provides support for SSL/TLS encryption. This error signifies tha...
Nginx Stream Core Module Configuration Error
The `ngx_stream_core_module` is a core module in Nginx responsible for TCP and UDP proxying. This er...
Nginx Core Module Configuration Error
The `ngx_http_core_module` is the fundamental module in Nginx, responsible for handling core HTTP fu...
Nginx Upstream Module Configuration Error
The `ngx_http_upstream_module` in Nginx allows defining a group of backend servers (upstreams) that ...
Nginx Proxy Module Configuration Error
The `ngx_http_proxy_module` in Nginx is responsible for proxying requests to backend servers. Errors...
Nginx Mail Core Module Configuration Error
The `ngx_mail_core_module` in Nginx handles the core functionality for the mail proxy feature, enabl...
Nginx 403 Forbidden Error
The 403 Forbidden error indicates that the server understands the request, but is refusing to fulfil...
502 Bad Gateway Error on Nginx
The 502 Bad Gateway error on Nginx signifies that the server, acting as a gateway or proxy, received...
504 Gateway Timeout Error in Nginx
The 504 Gateway Timeout error indicates that Nginx, acting as a reverse proxy or load balancer, did ...
Nginx Limit Request Module Configuration Issues
The `ngx_http_limit_req_module` in Nginx is used to limit the request processing rate per defined ke...
Best Practices for Nginx Stability
Maintaining a stable Nginx environment requires proactive monitoring. Many of the errors listed above can be prevented by regular updates, proper caching configurations, and strict permission management. If you are a developer, ensure you are checking the platform's specific error logs, which often contain more detail than the public-facing error message.
Whether you are dealing with API rate limits, server timeouts, or authentication failures, the solutions provided here are tested and verified. Bookmark this page to have a quick reference guide whenever Nginx throws an unexpected exception.