bartosjiri / nginx-errors

A set of custom minimalist 4xx and 5xx error pages for Nginx.

Minimalist Nginx error pages

A set of custom minimalist 4xx and 5xx error pages for Nginx.

Preview

Installation

1. Navigate into Nginx's default document directory:

   cd /usr/share/nginx/html
   

2. Clone the repository:

   git clone https://github.com/bartosjiri/nginx-errors.git
   

3. Add the custom error pages to the server's default configuration in /etc/nginx/sites-enabled/default file:

   server {
   ...
   include /usr/share/nginx/html/nginx-errors/nginx-errors.conf
   }
   

4. Verify the configuration and reload Nginx:

   sudo nginx -t
   sudo service nginx reload
   

nginx-errors's Issues

nginx: [emerg] unexpected "}"

In the README.md there is a missing semicolon after the include.

server {
...
include /usr/share/nginx/html/nginx-errors/nginx-errors.conf;
}

401 error page not loaded, set auth_basic off;

if auth_basic is enabled, the default 401 error page will be shown, not the styled one.

to fix this, the error locations should have auth_basic off;

nginx-errors.conf:

...

location ^~ /nginx-errors/errors/ {
    auth_basic off;
    ssi on;
    internal;
    root /usr/share/nginx/html;
}

location ^~ /assets/css/style.css {
    auth_basic off;
    root /usr/share/nginx/html/nginx-errors/errors;
}

location ~* montserrat-(400|700).(eot|woff2|woff|ttf|svg) {
    auth_basic off;
    root /usr/share/nginx/html/nginx-errors/errors;
}