Picture for Overcome Issues with Nginx Configuration.
Picture by Matt Chad

If you're running a website or web application using Nginx, you may encounter errors that can disrupt your site's functionality. Fortunately, many of these errors have straightforward solutions that can be implemented quickly and easily. In this guide, we'll explore some of the most common Nginx errors and provide solutions to help you overcome them.

Each error is organized with an example nginx error and explanation to the error cause. Next to it there is a solution backed by a link to the documentation - where possible.

This guide is a living document and is constantly updated.

Error while SSL handshaking in Nginx

This is a common issue for proxy servers. You might encounter a following error in the Nginx error log:

SSL_do_handshake() failed (SSL: error:14201044:SSL routines:tls_choose_sigalg:internal error) while SSL handshaking, client:, server:

Solution to SSL_do_handshake() failed with Nginx proxy

Simply enable passing of the server name through TLS Server Name Indication extension (SNI) in the proxy server config section:

proxy_ssl_server_name on; 

Example server config snippet:

# file: /etc/nginx/sites-available/{YOUR_WEBSITE}
location / {
     # Add next line
    proxy_ssl_server_name on;
    # Rest of the config

Read more about proxy_ssl_server_name in the Nginx documentation.