Error Pages
Freundliche Fehlerseiten statt einer kargen 502.
Kurz gesagt
Error Pages liefert hinter deinem Reverse Proxy eine verständliche Seite für jeden gängigen HTTP-Fehler, dazu eine Wartungsseite, die du im laufenden Betrieb schaltest. Fünf Themes, vier Sprachen mit automatischer Erkennung. Keine externen Anfragen, keine Cookies, kein Tracking.
- Für wen?
- Alle, die Websites oder Dienste hinter einem Reverse Proxy betreiben und ihren Besuchern bessere Fehlerseiten zeigen wollen.
- Läuft auf
- DockerTraefikingress-nginxReverse Proxy
- Was kostet es?
- Nichts. Der Code ist offen, unter MIT-Lizenz.
Worum es geht
Ein Backend fällt aus, und deine Besucher sehen eine nackte Zeile Text. Oder eine Route passt nicht, und es kommt eine Standardseite, die niemand versteht. Das ist kein Weltuntergang, wirkt aber lieblos.
Error Pages ist ein kleiner Container, der hinter deinem Reverse Proxy für jeden gängigen Fehler eine verständliche Seite ausliefert. In der Sprache deiner Besucher, ohne Einrichtung und ohne Daten an Dritte. Dazu kommt eine Wartungsseite, die du einschaltest, wenn du an etwas arbeitest.
Was es kann
Seiten
- Seiten für 400 bis 505, dazu eine allgemeine Seite für jeden anderen 4xx- oder 5xx-Code.
- Fünf Themes:
glass,terminal,classic,statusundclean. Auf Wunsch bei jedem Aufruf ein zufälliges. - Deutsch, Englisch, Polnisch und Französisch, automatisch erkannt und auf der Seite umschaltbar.
- Eigene Footer-Links und Copyright, auf Wunsch mit Zeit, Host und Request-ID.
- API-Clients bekommen JSON oder Text statt HTML.
Wartung
- Wartungsseite im laufenden Betrieb ein- und ausschalten.
- Optional mit Endzeitpunkt. Besucher sehen, wann es weitergeht, und es wird ein
Retry-After-Header gesendet.
Datenschutz und Zugänglichkeit
- Keine externen Anfragen, keine Cookies, kein Tracking.
- Jede Seite ist in sich geschlossen und kommt mit einer einzigen Anfrage an.
- Funktioniert ohne JavaScript, ab 320 px Breite und respektiert reduzierte Bewegung.
- Ein sehr kleines Image, das schreibgeschützt und ohne Root-Rechte läuft.
So legst du los
Zum Ausprobieren:
docker run -p 8080:8080 noixdev/error-pagesDanach zum Beispiel http://localhost:8080/502.html öffnen. Wie du Error Pages hinter Traefik oder einem anderen Reverse Proxy einbindest und welche Optionen es gibt, steht in der Dokumentation. Neue Themes und Übersetzungen nehmen wir gern auf GitHub entgegen.
Error Pages im Vergleich
Wir mögen die anderen Tools auch. Hier stehen sie ehrlich nebeneinander.
| Error Pages | tarampampam/error-pages | nginx-Standardseiten | Traefik ohne Fehlerseiten-Dienst | |
|---|---|---|---|---|
| Gestaltete Seiten für die gängigen Fehlercodes | ✓ja | ✓ja | –nein | –nein |
| Auswahl an Designs | 5 Themes | 11 Vorlagen | –nein | –nein |
| Mehrsprachig | 4 Sprachen, automatisch erkannt | 15+ Sprachen | –nein | –nein |
| Wartungsseite im laufenden Betrieb schaltbar | ✓ja | –nein | nur per eigener Konfiguration | nur per eigener Konfiguration |
| Kommt ohne zusätzlichen Container aus | –nein | –nein | ✓ja | ✓ja |
Stand: November 2026. Angaben ohne Gewähr, Korrekturen gern als Issue.
Wann etwas anderes besser passt
Nicht jedes Werkzeug passt zu jeder Aufgabe. In diesen Fällen würden wir dir selbst etwas anderes empfehlen:
Wenn du mehr Vorlagen oder Sprachen brauchst, oder Fehler auch als XML ausliefern willst.
Die Standardseiten deines Servers
Wenn Fehlerseiten für dich keine Rolle spielen und du keinen weiteren Container betreiben willst.
Häufige Fragen
Wie bekomme ich eigene Fehlerseiten in Traefik?
Du startest Error Pages als Container und hängst die errors-Middleware von Traefik an deine Router. Ein Catch-all-Router mit niedriger Priorität zeigt zusätzlich die 404-Seite für alles, was sonst nicht passt.
Ist Error Pages eine Alternative zu tarampampam/error-pages?
Ja, beide machen dasselbe Grundsätzliche. Error Pages hat weniger Vorlagen, bringt aber eine Wartungsseite mit, die du im laufenden Betrieb schaltest.
Wie schalte ich die Wartungsseite ein?
Mit docker exec error-pages /error-pages maintenance on, optional mit --until und einer Uhrzeit. Solange sie aktiv ist, wird jede 5xx-Seite durch die Wartungsseite ersetzt.
Lädt die Seite externe Schriften oder Skripte?
Nein. Styles, Schriften und Skripte stecken in der Seite selbst. Sie kommt mit einer einzigen Anfrage an, auch wenn alles dahinter ausgefallen ist.
Welche Sprachen gibt es?
Deutsch, Englisch, Polnisch und Französisch. Die Sprache kommt aus dem Browser, aus ?lang= oder aus der gespeicherten Wahl des Besuchers.
Funktioniert es mit ingress-nginx?
Ja. Proxys, die den Status im Header X-Code mitschicken, wie das Custom Error Backend von ingress-nginx, werden unterstützt.
Etwas kaputt, oder fehlt dir etwas?
Ein Issue im Repository ist der schnellste Weg. Auch für Wünsche und Rückfragen.
Issue anlegenLieber direkt fragen?
Auf unserem Discord helfen wir dir weiter, und andere, die das Tool nutzen, auch.
Discord beitretenAus dem Logbuch
- Neues Projekt
Neu: Error Pages, Fehlerseiten zum Selbsthosten
Freundliche, schnelle Fehlerseiten für deine Websites und Dienste. Mit fünf Themes, vier Sprachen und einer Wartungsseite zum Ein- und Ausschalten.