Self-hosted error-page service that serves styled HTTP error pages per domain, shipping 64 themes and playlists that rotate between them, with low-code customisation so pages can be edited without touching the stack.
See the codeSee what people are saying
README
Fairer Pages
A comprehensive error pages as a service workflow. Fairer Pages is open-source, ships with 64 themes, and it also has the ability to serve fairer-pages as playlists. You will have fine grain control over your fairer-pages for each and every domain. The design is low-code so it is easier for you to understand and add your flare! Let us see your custom fairer-pages!!!
Image contents
Base:
Packages:
Features:
| Fairer-Pages as a Service | Fairer-pages is deployable via docker and kubernetes, allowing you to deploy it in minutes and it is simple to add your own flair |
| Themes | At the time of writing there are 64 Unique Themes, some sourced from other authors and tweaked/generated with AI. |
| Fairer-Code Personality | Themes change context based on the error code encountered and configuration is simple so you can tweak everything to satisfaction. (Fairer Pages supports all codes from 4xx-5xx.) |
| Playlists | Playlists are collections of themes. Group themes by mood, purpose, or audience to curate error pages for every domain you control. |
| Hardened Container | Runs non-root (UID 10000), read-only root filesystem, all capabilities dropped, no privilege escalation. Safe to put in front of your services. |
| Self-Contained Documentation | Fairer Pages ships with a copy of the relevant documentation served within the container for convenience. |
Documentation:
| Themes | Overview / Gallery |
| Playlists | Guide |
| Docker | Install Guide |
| Kubernetes | Install Guide |
| Nginx | Integration |
Installation
docker run -d --name fairer-pages --restart always -p 8023:8080 prplanit/fairer-pages:latest
This project is near 100% HTML & JS, it should not be dependent on Docker/K8s, let alone NGINX. Feel free to explore this.
Usage
Error pages are served at /fairer-pages/ on the container (port 8080).
| URL Pattern | Description |
|---|---|
/fairer-pages/<theme>/<code>.html | Specific theme |
/fairer-pages/random/<code>.html | Random theme each time |
/fairer-pages/playlist/<name>/<code>.html | Random from a named playlist |
Examples:
| URL | Result |
|---|---|
localhost:8023/fairer-pages/back2thefuture/404.html | Back to the Future 404 |
example.com/fairer-pages/playlist/work/502.html | Random work-appropriate 502 |
example.com/fairer-pages/random/404.html | Random theme 404 |
Contributing
- File issues with steps, logs, and versions.
- Small, focused PRs are best (typos, fairer handling, UI polish).
- Theme contributions are welcome!
- Security-related PRs and hardening suggestions are especially appreciated if you notice anything that can be improved.
Disclaimer
The Software provided hereunder ("Software") is licensed "as-is," without warranties of any kind—express, implied, or whispered by mystical wisps. The Softwarer (yes, that's totally a word now) makes no promises about functionality, performance, compatibility, security, or availability—and absolutely no warranty of any sort. The developer shall not be held responsible, even if the software is clearly the reason your 404 page became more entertaining than your actual content, your users spent three hours clicking through every theme instead of buying anything, or your error pages gained sentience and started redirecting to Rick Astley videos.
If using this error page collection leads you down a rabbit hole of obsessive theme customization, breaks your carefully crafted nginx configs, or causes an uprising among your regex location blocks—sorry, still not liable. Also not liable if your random theme selector becomes so addictive it crashes your analytics or if your resource paths multiply like lightning bolts in a DeLorean. The developer likewise claims no credit for anything that actually goes right either. Any positive experiences are owed entirely to the unstoppable force that is the Open Source community.
Just don't blame me when your creative ways to cause errors in your environment for "testing" purposes inevitably backfires.
License
Distributed under the AGPL-3.0-only License. See LICENSING.md for commercial licensing.
Contributors
198 commits
Similar repos
Languages
HTML
63.2%
CSS
32.7%
Shell
2.4%
JavaScript
1.4%
Self-hosted error-page service that serves styled HTTP error pages per domain, shipping 64 themes and playlists that rotate between them, with low-code customisation so pages can be edited without touching the stack.
See the codeSee what people are saying
README
Fairer Pages
A comprehensive error pages as a service workflow. Fairer Pages is open-source, ships with 64 themes, and it also has the ability to serve fairer-pages as playlists. You will have fine grain control over your fairer-pages for each and every domain. The design is low-code so it is easier for you to understand and add your flare! Let us see your custom fairer-pages!!!
Image contents
Base:
Packages:
Features:
| Fairer-Pages as a Service | Fairer-pages is deployable via docker and kubernetes, allowing you to deploy it in minutes and it is simple to add your own flair |
| Themes | At the time of writing there are 64 Unique Themes, some sourced from other authors and tweaked/generated with AI. |
| Fairer-Code Personality | Themes change context based on the error code encountered and configuration is simple so you can tweak everything to satisfaction. (Fairer Pages supports all codes from 4xx-5xx.) |
| Playlists | Playlists are collections of themes. Group themes by mood, purpose, or audience to curate error pages for every domain you control. |
| Hardened Container | Runs non-root (UID 10000), read-only root filesystem, all capabilities dropped, no privilege escalation. Safe to put in front of your services. |
| Self-Contained Documentation | Fairer Pages ships with a copy of the relevant documentation served within the container for convenience. |
Documentation:
| Themes | Overview / Gallery |
| Playlists | Guide |
| Docker | Install Guide |
| Kubernetes | Install Guide |
| Nginx | Integration |
Installation
docker run -d --name fairer-pages --restart always -p 8023:8080 prplanit/fairer-pages:latest
This project is near 100% HTML & JS, it should not be dependent on Docker/K8s, let alone NGINX. Feel free to explore this.
Usage
Error pages are served at /fairer-pages/ on the container (port 8080).
| URL Pattern | Description |
|---|---|
/fairer-pages/<theme>/<code>.html | Specific theme |
/fairer-pages/random/<code>.html | Random theme each time |
/fairer-pages/playlist/<name>/<code>.html | Random from a named playlist |
Examples:
| URL | Result |
|---|---|
localhost:8023/fairer-pages/back2thefuture/404.html | Back to the Future 404 |
example.com/fairer-pages/playlist/work/502.html | Random work-appropriate 502 |
example.com/fairer-pages/random/404.html | Random theme 404 |
Contributing
- File issues with steps, logs, and versions.
- Small, focused PRs are best (typos, fairer handling, UI polish).
- Theme contributions are welcome!
- Security-related PRs and hardening suggestions are especially appreciated if you notice anything that can be improved.
Disclaimer
The Software provided hereunder ("Software") is licensed "as-is," without warranties of any kind—express, implied, or whispered by mystical wisps. The Softwarer (yes, that's totally a word now) makes no promises about functionality, performance, compatibility, security, or availability—and absolutely no warranty of any sort. The developer shall not be held responsible, even if the software is clearly the reason your 404 page became more entertaining than your actual content, your users spent three hours clicking through every theme instead of buying anything, or your error pages gained sentience and started redirecting to Rick Astley videos.
If using this error page collection leads you down a rabbit hole of obsessive theme customization, breaks your carefully crafted nginx configs, or causes an uprising among your regex location blocks—sorry, still not liable. Also not liable if your random theme selector becomes so addictive it crashes your analytics or if your resource paths multiply like lightning bolts in a DeLorean. The developer likewise claims no credit for anything that actually goes right either. Any positive experiences are owed entirely to the unstoppable force that is the Open Source community.
Just don't blame me when your creative ways to cause errors in your environment for "testing" purposes inevitably backfires.
License
Distributed under the AGPL-3.0-only License. See LICENSING.md for commercial licensing.
Similar repos
Contributors
198 commits
Languages
HTML
63.2%
CSS
32.7%
Shell
2.4%
JavaScript
1.4%