Ga naar de inhoud

Categorie: HomeLab

NPM / NGINX Custom error pages

We kennen het allemaal wel… een saaie error pagina, 404 niet gevonden of erger 403 geen toegang. In 2023 heb ik mijn HAProxy op PFSense al voorzien van opgefleurde error pagina’s klik hier om daar meer over te lezen. Maar nu ga ik vertellen hoe ik dit gedaan heb voor mijn NPM installatie.

In deze handleiding heb ik gebruik gemaakt van de Proxmox VE Helper Scripts installatie van Nginx Proxy Manager en NPMplus. Dit zou voor een zelfstandige installatie van NPM dan wel NGINX niets uit mogen maken alleen zijn de paden niet plug en play.

Ik heb in het verleden voor HAProxy op PFSense een mooie collectie gemaakt, mocht je deze gebruiken dan moet je ze kopieeren vanaf de eerste html tag <!DOCTYPE html>... Een andere leuke bron voor error pagina’s is: TheSL18/errorpages


Voor we beginnen gaan we een paar mappen en bestanden aanmaken.

mkdir -p /data/nginx/custom
mkdir -p /data/nginx/error_pages
touch /data/nginx/custom/server_proxy.conf

Plaats je error documenten in cd /data/nginx/error_pages met de naam <errorcode>.html

Open nano /data/nginx/custom/server_proxy.conf en plaats de onderstaande config in het bestand. Uncomment vervolgens de regels die je wilt activeren als error pagina.

#error_page 400 /error_pages/400.html;
#error_page 401 /error_pages/401.html;
#error_page 402 /error_pages/401.html;
#error_page 403 /error_pages/403.html;
#error_page 404 /error_pages/404.html;
#error_page 405 /error_pages/405.html;
#error_page 407 /error_pages/407.html;
#error_page 408 /error_pages/408.html;
#error_page 409 /error_pages/409.html;
#error_page 410 /error_pages/410.html;
#error_page 411 /error_pages/411.html;
#error_page 412 /error_pages/412.html;
#error_page 413 /error_pages/413.html;
#error_page 416 /error_pages/416.html;
#error_page 418 /error_pages/418.html;
#error_page 429 /error_pages/429.html;
#error_page 500 /error_pages/500.html;
#error_page 501 /error_pages/501.html;
#error_page 502 /error_pages/502.html;
#error_page 503 /error_pages/503.html;
#error_page 504 /error_pages/504.html;
#error_page 505 /error_pages/505.html;
proxy_intercept_errors on;

location /error_pages/ {
    alias /data/nginx/error_pages/;
    internal;
}

Herstart de machine met reboot

Een deel van deze informatie is met liefde gejat vanaf: https://www.synoforum.com/resources/how-to-setup-custom-error-pages-for-nginx-proxy-manager-npm.205/

Copyright Ronald van Heugten 1990 - 2026