๐ง Pretty server's error pages in the docker image & git repository (for traefik, k8s, nginx and so on)
22 feb. 2022 - โก Our Docker image was downloaded one MILLION times from the docker hub! โก
10 apr. 2023 - โก Two million times from the docker hub and one million from the ghcr! โก
One day you may want to replace the standard error pages of your HTTP server with something more original and pretty. That's what this repository was created for :) It contains:
Content-Type
HTTP header (and X-Format
) value and responds with the corresponding format (supported formats are json
and xml
)json
format/healthz
)/metrics
) in Prometheus formatnginx
docker imageDownload the latest binary file for your os/arch from the releases page or use our docker image:
Registry | Image |
---|---|
Docker Hub | tarampampam/error-pages |
GitHub Container Registry | ghcr.io/tarampampam/error-pages |
Using the
latest
tag for the docker image is highly discouraged because of possible backward-incompatible changes during major upgrades. Please, use tags inX.Y.Z
format
๐ฃ Or you can download already rendered error pages pack as a zip or tar.gz archive.
Please, take a look at our Wiki for the common usage stories:
Used hardware:
$ ulimit -aH | grep file
-f: file size (blocks) unlimited
-c: core file size (blocks) unlimited
-n: file descriptors 1048576
-x: file locks unlimited
$ docker run --rm -p "8080:8080/tcp" -e "SHOW_DETAILS=true" error-pages:local # in separate terminal
$ wrk --timeout 1s -t12 -c400 -d30s -s ./test/wrk/request.lua http://127.0.0.1:8080/
Running 30s test @ http://127.0.0.1:8080/
12 threads and 400 connections
Thread Stats Avg Stdev Max +/- Stdev
Latency 10.84ms 7.89ms 135.91ms 79.36%
Req/Sec 3.23k 785.11 6.30k 70.04%
1160567 requests in 30.10s, 4.12GB read
Requests/sec: 38552.04
Transfer/sec: 140.23MB
Name | Preview |
---|---|
ghost |
|
l7-light |
|
l7-dark |
|
shuffle |
|
noise |
|
hacker-terminal |
|
cats |
|
lost-in-space |
|
app-down |
|
connection |
|
matrix |
|
orient |
Note:
noise
template highly uses the CPU, be careful
I want to say a big thank you to everyone who contributed to this project:
Changes log can be found here.
If you find any bugs in the project, please create an issue in the current repository.
This is open-sourced software licensed under the MIT License.