Static file serving

Configure Ferron as a static file server with the root directive. The directive sets the directory that contains your static files. Use this configuration:

example.com {
    root /var/www/html
}

HTTP compression for static files⁠#

Ferron enables HTTP compression for static files by default. To disable it, use this configuration:

example.com {
    root /var/www/html
    compressed false
}

Directory listings⁠#

Ferron disables directory listings by default. To enable them, use this configuration:

example.com {
    root /var/www/html
    directory_listing
}

Single-page applications⁠#

Ferron also supports single-page applications (SPAs). Add a URL rewrite rule to the static file serving configuration. Use this configuration:

example.com {
    root /var/www/html
    rewrite "^/.*" "/" {
        last
        directory false
        file false
    }
}

Static file serving with caching headers⁠#

Ferron supports setting Cache-Control headers for static files. To enable caching headers for static files, you can use this configuration:

example.com {
    root /var/www/html
    etag
    file_cache_control "public, max-age=3600"
}

Serving precompressed static files⁠#

Ferron supports serving precompressed static files (sidecar files like app.js.gz, app.js.br). To enable this feature, you can use this configuration:

example.com {
    root /var/www/html
    precompressed
}

In this configuration, Ferron serves precompressed versions of static files if they exist. The precompressed files use the .gz extension for gzip, .br for Brotli, .deflate for Deflate, and .zst for Zstandard.