Set up a custom 404 page for static sites with Caddy 2

Oh Dear monitors your entire site, not just the homepage. We crawl and search for broken pages and mixed content, send alerts when your site is down and notify you on expiring SSL certificates.

Start your free 10 day trial! »

Profile image of Mattias Geniar

Mattias Geniar, April 26, 2020

Follow me on Twitter as @mattiasgeniar

Here’s a quick example of setting up a custom 404 landing page if you use Caddy V2 to serve static sites, like this blog.

On Caddy 2 {
    root * /var/www/html/

    handle_errors {
        @404 {
            expression {http.error.status_code} == 404
        rewrite @404 /404.html

The handle_errors directive allows you to create a new rule that mandates that every 404 page should be served /404.html.

This assumes you have a file called 404.html in your root directory (like I do here: that can get served.

On Caddy 1

For completeness sake, here’s how it was done in Caddy V1. {
    root /var/www/html/

    errors /var/www/html/ {
        404 404.html

As part of the errors directive, you could specify which file to serve as a 404-error.

Want to subscribe to the cron.weekly newsletter?

I write a weekly-ish newsletter on Linux, open source & webdevelopment called cron.weekly.

It features the latest news, guides & tutorials and new open source projects. You can sign up via email below.

No spam. Just some good, practical Linux & open source content.