Skip to content

markusgut/custom-error-pages

Repository files navigation

Custom Error Pages – for Nginx, Apache & others

Static Badge Static Badge GitHub package.json version GitHub License Github Repository

A full set of custom HTTP error pages for webserver like Nginx, Apache or others. Can be used out of-the-box without any hassle, or can be fully customized easily. Comes with multi-language support and translations for many languages already included.

Our generic and minimalistic default design is perfect to be used without any modification in almost every situation. Just download one of the prerendered releases. If you want to use a language not yet included or want to make changes to design or code, you'd need to download the source code from github (using git or your web browser), make your modifications and generate all resulting html files automatically.

The full set counts 40 pages, covering virtually all HTTP 4xx (client error) and HTTP 5xx (server error) status codes which could ever end up on your visitor's screen. Even the notorious 418!

How to use error pages

Prerequisites

  • Node.js (get it here) – Please note that Node.js is only required for generation of static files.

Usage

To render a full set of error pages, clone our repository, run npm install and npm run build:

git glone custom-error-pages/custom-error-pages
npm install
npm run build

After generation is complete, you find the generated files in build.

Configure your webserver to use these as custom error pages.

Version Notes

v0.1.0-alpha (current)WORK IN PROGRESS! Might be incomplete or broken.

Known Limitations

  • Currently, does neither generate nor include any browser configuration.

  • We have not released any prerendered sets yet.

Origin Story

@markusgut was looking for a full set of custom HTTP error pages, and found @bartosjiri/nginx-errors to be great starting point. While customizing a few details, things got somewhat out of hand, leading to him adding a full build system with multi language support, allowing users to quickly and easily generate full sets of customized, consistent HTTP error pages in multiple languages.

License

BSD-2-Clause

Contributors

About

Create full sets of custom HTTP error pages for Nginx, Apache or other web servers. Fully customizable & supports multiple languages.

Resources

License

Stars

Watchers

Forks

Contributors