<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>docs/content/index.md - fork/static-web-server @ allow-symlink</title>
<meta name="description" content="docs/content/index.md in fork/static-web-server at allow-symlink.">
<meta property="og:title" content="docs/content/index.md - fork/static-web-server @ allow-symlink">
<meta property="og:description" content="docs/content/index.md in fork/static-web-server at allow-symlink.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="allow-symlink" data-tip="4414610fe1b0370ff0ac415e9367548840584710">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/static-web-server</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/static-web-server</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Chris Snell</span><span class="commit-message" data-commit="0a8c8cac01228b0ac5a7f0ce59d51eef8800e12b">docs: metrics feature documenation page (#633)</span><span class="snapshot-sha sha" data-commit="0a8c8cac01228b0ac5a7f0ce59d51eef8800e12b">0a8c8ca</span><time datetime="2026-02-27T13:49:40-07:00" title="2026-02-27 13:49:40 -0700">2026-02-27</time></p>
<header class="topbar"><details class="switcher"><summary>allow-symlink</summary><div class="menu"><strong>branches</strong><a class="current" href="/fork/static-web-server/ref/allow-symlink/">allow-symlink</a><a class="all" href="/fork/static-web-server/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/static-web-server/">static-web-server</a> / <a href="/fork/static-web-server/ref/allow-symlink/tree/docs/">docs</a> / <a href="/fork/static-web-server/ref/allow-symlink/tree/docs/content/">content</a> / <span class="cur">index.md</span></nav>
<span class="view-stats"><span>13.3 KiB</span><span>88 lines</span></span><span class="actions"><a class="raw" href="/fork/static-web-server/raw/179e7caabea447055e075f13a8aa6eea5934b1a9/docs/content/index.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered">&lt;div style="overflow: hidden; clear: both;"&gt;
  &lt;div align="center" class="sws-logo"&gt;
    &lt;a href="https://static-web-server.net" title="static-web-server website"&gt;
    &lt;svg xmlns="http://www.w3.org/2000/svg" width="100" height="100" viewBox="0 0 53.505 53.505"&gt;&lt;path d="M161.49 84.99a.664.664 0 0 0-.38.149c-.081.07-.498.613-.927 1.207l-.778 1.079-.232.014c-.56.032-.46.11-1.354-1.054-.445-.58-.873-1.104-.95-1.165a.909.909 0 0 0-.345-.15c-.174-.03-.234-.02-.41.072a.873.873 0 0 0-.292.246c-.047.077-.327.672-.623 1.323-.594 1.309-.516 1.213-1.068 1.308l-.23.04-1.003-.874c-.552-.48-1.081-.914-1.177-.964-.327-.17-.8-.009-.946.321-.036.083-.198.719-.36 1.414-.163.695-.317 1.29-.345 1.324-.027.033-.188.12-.358.192l-.31.132-1.224-.707c-1.162-.67-1.239-.707-1.473-.697a.68.68 0 0 0-.403.12c-.273.193-.313.385-.354 1.719-.021.667-.042 1.285-.047 1.374-.008.14-.047.185-.317.362l-.309.203-1.296-.438c-1.449-.49-1.628-.519-1.883-.3-.084.073-.193.21-.243.306-.105.204-.102.244.172 1.87.104.612.183 1.136.176 1.164-.007.027-.122.159-.256.292l-.243.243-1.328-.172c-.73-.094-1.415-.16-1.52-.148a.717.717 0 0 0-.612.773c.011.105.232.756.49 1.446l.468 1.254-.18.292c-.1.16-.202.303-.227.316-.025.013-.553.054-1.173.093-1.646.103-1.685.109-1.86.258-.082.07-.19.207-.242.305-.157.3-.088.467.72 1.765l.722 1.161-.128.348c-.112.305-.147.354-.282.393-.084.025-.682.186-1.327.358-1.29.344-1.467.426-1.593.736a.677.677 0 0 0-.025.42c.044.23.097.296 1.014 1.275l.967 1.032-.058.332c-.033.182-.08.358-.106.392-.026.034-.571.32-1.211.636-.64.316-1.223.619-1.295.673-.275.208-.334.696-.117.974.059.076.606.498 1.216.937l1.108.8.008.274c.005.151.005.324 0 .383-.007.079-.277.312-1.042.9-.567.437-1.084.846-1.148.91a.876.876 0 0 0-.173.34c-.05.192-.046.252.024.415.045.105.146.24.223.302.078.061.687.358 1.353.66.899.408 1.22.576 1.244.652.018.056.058.224.088.372l.055.27-.897 1.03c-.494.566-.93 1.101-.971 1.189-.148.32.02.782.336.921.082.037.718.2 1.413.362.696.162 1.292.316 1.324.343.033.027.12.189.193.359l.132.309-.708 1.226c-.67 1.161-.706 1.238-.697 1.471.007.18.04.29.12.403.194.274.385.313 1.72.355.667.02 1.285.041 1.373.046.14.008.186.048.364.32l.203.309-.436 1.289c-.24.708-.44 1.361-.444 1.45-.01.218.052.365.221.525.29.273.31.273 1.713.05.693-.11 1.324-.219 1.402-.24.126-.034.169-.01.41.23l.27.268-.172 1.328c-.095.73-.16 1.413-.148 1.518.045.37.401.653.772.613.105-.01.756-.231 1.446-.49l1.255-.469.292.181c.16.1.302.202.315.227.013.025.055.553.094 1.174.102 1.645.108 1.684.258 1.859.07.082.207.19.305.242.299.156.467.088 1.766-.72l1.163-.721.352.13c.194.07.355.14.355.154.025.215.715 2.625.789 2.753a.795.795 0 0 0 .295.274c.163.083.235.09.449.048.244-.05.295-.09 1.286-1.019l1.033-.967.331.059c.182.032.359.079.393.105.034.026.32.571.636 1.211.316.64.62 1.223.673 1.295.217.288.714.336.994.097.082-.07.499-.613.927-1.206l.777-1.08.305-.019c.167-.01.343-.014.39-.006.047.008.448.488.891 1.067.444.579.846 1.088.893 1.133a.952.952 0 0 0 .288.147c.252.083.345.072.578-.068.221-.132.256-.196.91-1.64.268-.595.524-1.096.568-1.114.044-.018.215-.056.381-.083l.301-.05 1.004.873c.551.481 1.08.915 1.176.965.327.169.8.009.945-.321.037-.083.2-.719.362-1.414.162-.695.317-1.291.344-1.324.027-.033.188-.12.358-.192l.31-.133 1.225.707c1.161.67 1.238.707 1.471.698a.678.678 0 0 0 .403-.12c.275-.195.315-.385.355-1.72.02-.666.041-1.285.046-1.373.008-.14.049-.185.32-.364l.31-.203 1.294.439c1.448.491 1.626.52 1.882.3.084-.073.193-.21.243-.306.106-.204.102-.244-.172-1.87-.104-.612-.183-1.136-.176-1.163.007-.027.122-.16.255-.293l.243-.242 1.33.171c.73.094 1.414.161 1.519.148a.717.717 0 0 0 .612-.772c-.01-.105-.231-.756-.49-1.446l-.469-1.255.181-.292c.1-.16.202-.302.227-.315.025-.013.553-.055 1.174-.094 1.645-.103 1.684-.108 1.859-.257.082-.07.19-.208.242-.306.157-.3.088-.466-.72-1.764l-.722-1.162.128-.347c.112-.305.147-.354.282-.394.085-.025.681-.186 1.326-.358 1.29-.344 1.468-.426 1.594-.736a.676.676 0 0 0 .025-.42c-.044-.229-.096-.295-1.014-1.274l-.967-1.033.058-.33c.033-.183.08-.36.106-.393.026-.033.57-.318 1.208-.634.639-.315 1.221-.619 1.295-.674.29-.219.34-.715.1-.996-.07-.082-.613-.5-1.207-.927l-.054-.04-.55-1.873c.17-.139.347-.282.566-.45.579-.443 1.095-.854 1.148-.914a.957.957 0 0 0 .15-.326c.048-.186.044-.247-.026-.41a.905.905 0 0 0-.223-.3c-.078-.062-.685-.358-1.35-.66-.665-.301-1.223-.584-1.241-.628a2.895 2.895 0 0 1-.083-.38l-.05-.3.874-1.003c.48-.552.914-1.082.964-1.178.17-.328.009-.8-.324-.947-.085-.037-.72-.2-1.414-.362-.694-.162-1.288-.316-1.321-.342-.03-.025-.104-.164-.172-.316l-.12-.407.675-1.17c.67-1.162.706-1.238.697-1.472-.007-.178-.04-.29-.12-.403-.193-.273-.385-.313-1.72-.354-.666-.021-1.284-.042-1.372-.047-.14-.008-.186-.048-.365-.32l-.203-.309.44-1.295c.49-1.447.52-1.626.299-1.881a1.235 1.235 0 0 0-.306-.243c-.204-.106-.243-.102-1.869.172-.613.103-1.137.183-1.164.176-.027-.007-.159-.122-.292-.256l-.243-.242.172-1.33c.094-.73.16-1.414.147-1.519a.717.717 0 0 0-.772-.613c-.105.012-.756.232-1.446.49l-1.255.47-.292-.181c-.16-.1-.301-.202-.314-.227-.013-.025-.056-.554-.094-1.174-.103-1.645-.108-1.685-.258-1.86a1.236 1.236 0 0 0-.306-.242c-.299-.156-.467-.087-1.765.72l-1.16.723-.354-.13c-.195-.072-.357-.14-.357-.152-.025-.218-.715-2.63-.788-2.756a.802.802 0 0 0-.295-.274c-.163-.083-.235-.09-.449-.048-.244.05-.296.09-1.287 1.018l-1.033.968-.33-.059c-.183-.032-.36-.08-.394-.105-.034-.026-.32-.571-.635-1.211-.316-.64-.62-1.223-.674-1.295-.135-.18-.38-.266-.614-.247zm-.697 7.073.23.007c.772.027 2.37.305 3.543.618 1.461.39 2.871.954 4.201 1.67l-15.344 16.098 19.624-3.681-6.154 7.367 12.21-1.083c-.164 2.326-.664 4.402-1.554 6.473-.565 1.316-1.393 2.779-2.134 3.768l-.21.28-1.853-.083c-1.285-.056-1.935-.065-2.115-.028-.517.103-.958.5-1.118 1.001-.06.19-.101.723-.153 2.007-.038.961-.074 1.806-.08 1.877-.008.105-.077.168-.38.352-1.565.945-3.403 1.693-5.481 2.23-.636.163-3.37.523-4.096.538-2.105.044-4.413-.275-6.32-.874-.48-.15-.564-.193-.598-.3-.022-.068-.25-.884-.508-1.811-.342-1.232-.505-1.75-.607-1.92a1.507 1.507 0 0 0-1.317-.72c-.184.006-.814.162-2.052.51l-1.788.5-.267-.224c-.946-.794-2.086-2.03-2.935-3.183-1.563-2.121-2.609-4.365-3.314-7.108-.272-1.06-.592-3.89-.538-4.759.009-.152.061-.192 1.583-1.198 1.691-1.117 1.847-1.25 2.014-1.72.073-.205.08-.325.044-.657l-.046-.406-1.082-1.63-1.082-1.629.108-.264a23.32 23.32 0 0 1 .919-1.88 19.752 19.752 0 0 1 10.462-8.984c.31-.114.663-.235.782-.267l.219-.059 1.5 1.185c1.713 1.353 1.825 1.416 2.433 1.346.607-.07.703-.157 2.064-1.865z" transform="translate(-132.667 -84.987)"/&gt;&lt;/svg&gt;
    &lt;/a&gt;
  &lt;/div&gt;
&lt;h1 class="sws-title" align="center"&gt;Static Web Server&lt;/h1&gt;
&lt;h4 align="center"&gt;
    A cross-platform, high-performance &amp; asynchronous web server for static files serving
  &lt;/h4&gt;
&lt;div align="center"&gt;
    &lt;a href="https://github.com/static-web-server/static-web-server/actions/workflows/devel.yml" title="devel ci"&gt;&lt;img src="https://github.com/static-web-server/static-web-server/actions/workflows/devel.yml/badge.svg?branch=master"&gt;&lt;/a&gt; 
    &lt;a href="https://hub.docker.com/r/joseluisq/static-web-server/" title="Docker Image Version (tag latest semver)"&gt;&lt;img src="https://img.shields.io/docker/v/joseluisq/static-web-server/2"&gt;&lt;/a&gt; 
    &lt;a href="https://hub.docker.com/r/joseluisq/static-web-server/tags" title="Docker Image Size (tag)"&gt;&lt;img src="https://img.shields.io/docker/image-size/joseluisq/static-web-server/2"&gt;&lt;/a&gt; 
    &lt;a href="https://hub.docker.com/r/joseluisq/static-web-server/" title="Docker Image"&gt;&lt;img src="https://img.shields.io/docker/pulls/joseluisq/static-web-server.svg"&gt;&lt;/a&gt; 
    &lt;a href="https://crates.io/crates/static-web-server" title="static-web-server crate"&gt;&lt;img src="https://img.shields.io/crates/v/static-web-server.svg"&gt;&lt;/a&gt; 
    &lt;a href="https://docs.rs/static-web-server" title="static-web-server crate docs"&gt;&lt;img src="https://img.shields.io/docsrs/static-web-server/latest?label=docs.rs"&gt;&lt;/a&gt; 
    &lt;a href="https://github.com/static-web-server/static-web-server/blob/master/LICENSE-APACHE" title="static-web-server license"&gt;&lt;img src="https://img.shields.io/crates/l/static-web-server"&gt;&lt;/a&gt; 
    &lt;a href="https://discord.gg/VWvtZeWAA7" title="Static Web Server Community on Discord"&gt;
      &lt;img src="https://img.shields.io/discord/1086203405225164842?logo=discord&amp;label=discord"&gt;
    &lt;/a&gt;
  &lt;/div&gt;
&lt;/div&gt;
<h2>Overview</h2>
<p><strong>Static Web Server</strong> (or <strong><code>SWS</code></strong> abbreviated) is a tiny and fast production-ready web server suitable to serve static web files or assets.</p>
<p>It is focused on <strong>lightness and easy-to-use</strong> principles while keeping <a href="https://blog.rust-lang.org/2015/04/10/Fearless-Concurrency.html">high performance and safety</a> powered by <a href="https://rust-lang.org">The Rust Programming Language</a>.</p>
<p>Written on top of <a href="https://github.com/hyperium/hyper">Hyper</a> and <a href="https://github.com/tokio-rs/tokio">Tokio</a> runtime, it provides <a href="https://rust-lang.github.io/async-book/01_getting_started/02_why_async.html">concurrent and asynchronous networking abilities</a> and the latest HTTP/1 - HTTP/2 implementations.</p>
<p>Cross-platform and available for <code>Linux</code>, <code>macOS</code>, <code>Windows</code>, <code>FreeBSD</code>, <code>NetBSD</code>, <code>Android</code>, <code>Docker</code> and <code>Wasm</code> (via <a href="https://wasmer.io/wasmer/static-web-server">Wasmer</a>).</p>
<p><img src="https://github.com/static-web-server/static-web-server/assets/1700322/102bef12-1f30-4054-a1bc-30c650d4ffa7" alt="static-web-server running" /></p>
<h2>Features</h2>
<ul>
<li>Built with <a href="https://rust-lang.org">Rust</a>, which focuses on <a href="https://kornel.ski/rust-c-speed">safety, speed and concurrency</a>.</li>
<li>Memory-safe and significantly reduced CPU and RAM overhead.</li>
<li>Blazing fast static files-serving and asynchronous powered by the latest <a href="https://github.com/hyperium/hyper/">Hyper</a>, <a href="https://github.com/tokio-rs/tokio">Tokio</a> and a set of <a href="https://github.com/static-web-server/static-web-server/blob/master/Cargo.toml">awesome crates</a>.</li>
<li>Single <strong>4MB</strong> (uncompressed) and fully static binary with no dependencies (<a href="https://doc.rust-lang.org/edition-guide/rust-2018/platform-and-target-support/musl-support-for-fully-static-binaries.html">Musl libc</a>). Suitable for running on <a href="https://en.wikipedia.org/wiki/Linux_distribution">any Linux distro</a> or <a href="https://hub.docker.com/r/joseluisq/static-web-server/tags">Docker container</a>.</li>
<li>Optional GZip, Deflate, Brotli or Zstandard (zstd) compression for text-based web files only.</li>
<li>Compression on-demand via <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding">Accept-Encoding</a> header.</li>
<li>Markdown content negotiation via <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept">Accept</a> header for serving <code>.md</code> files.</li>
<li><a href="https://en.wikipedia.org/wiki/Byte_serving">Partial Content Delivery</a> support for byte-serving of large files.</li>
<li>Optional <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control">Cache-Control</a> headers for assets.</li>
<li><a href="https://www.gnu.org/software/libc/manual/html_node/Termination-Signals.html">Termination signal</a> handling with <a href="https://cloud.google.com/blog/products/containers-kubernetes/kubernetes-best-practices-terminating-with-grace">graceful shutdown</a> ability and grace period.</li>
<li><a href="https://tools.ietf.org/html/rfc7540">HTTP/2</a> and TLS support.</li>
<li><a href="https://web.dev/security-headers/">Security headers</a> for HTTP/2 by default.</li>
<li><a href="https://tools.ietf.org/html/rfc7231#section-4.3.2">HEAD</a> and <a href="https://datatracker.ietf.org/doc/html/rfc7231#section-4.3.7">OPTIONS</a> responses.</li>
<li>Lightweight and configurable logging via <a href="https://github.com/tokio-rs/tracing">tracing</a> crate.</li>
<li>Customizable number of blocking and worker threads.</li>
<li>Optional directory listing with sorting and JSON output format support.</li>
<li><a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS">CORS</a> with preflight requests support.</li>
<li>Basic HTTP Authentication.</li>
<li>Customizable HTTP response headers for specific file requests via glob patterns.</li>
<li>Fallback pages for 404 errors, useful for Single-page applications.</li>
<li>Run the server as a <a href="https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2003/cc783643(v=ws.10)">Windows Service</a>.</li>
<li>Configurable using CLI arguments, environment variables or a TOML file.</li>
<li>Default and custom error pages.</li>
<li>Built-in HTTP to HTTPS redirect.</li>
<li>GET/HEAD Health check endpoint.</li>
<li>Prometheus-compatible <code>/metrics</code> endpoint for traffic monitoring.</li>
<li>Support for serving pre-compressed (Gzip/Brotli/Zstd) files directly from disk.</li>
<li>Custom URL rewrites and redirects via glob patterns with replacements.</li>
<li>Virtual hosting support.</li>
<li>Multiple index files.</li>
<li>Maintenance Mode functionality.</li>
<li>Available as a library crate with opt-in features.</li>
<li>First-class <a href="https://docs.docker.com/get-started/overview/">Docker</a> support. <a href="https://hub.docker.com/_/scratch">Scratch</a>, latest <a href="https://hub.docker.com/_/alpine">Alpine Linux</a> and <a href="https://hub.docker.com/_/alpine">Debian</a> Docker images.</li>
<li>Ability to accept a socket listener as a file descriptor for sandboxing and on-demand applications (e.g. <a href="http://0pointer.de/blog/projects/socket-activation.html">systemd</a>).</li>
<li>Cross-platform. Pre-compiled binaries for Linux, macOS, Windows, FreeBSD, NetBSD, Android (<code>x86/x86_64</code>, <code>ARM/ARM64</code>) and WebAssembly (via <a href="https://wasmer.io/wasmer/static-web-server">Wasmer</a>).</li>
</ul>
<h2>Benchmarks</h2>
&lt;img title="SWS - Benchmarks April 2023" src="https://raw.githubusercontent.com/static-web-server/benchmarks/master/data/2023-04/benchmark-2023-04.png" width="860"&gt;
<p>For more details see <a href="https://github.com/static-web-server/benchmarks">the benchmarks repository</a>.</p>
<p>For feedback or questions feel free to reach us on <a href="https://github.com/static-web-server/static-web-server/discussions">the discussions page</a>.</p>
<h2>Community</h2>
<p><a href="https://discord.gg/VWvtZeWAA7">SWS Community on Discord</a></p>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>&lt;</a-p><a-tg>div</a-tg> <a-at>style</a-at>=&quot;<a-s>overflow: hidden; clear: both;</a-s>&quot;<a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"><a-p>  &lt;</a-p><a-tg>div</a-tg><a-p> </a-p><a-at>align</a-at><a-p>=&quot;</a-p><a-s>center</a-s><a-p>&quot; </a-p><a-at>class</a-at><a-p>=&quot;</a-p><a-s>sws-logo</a-s><a-p>&quot;&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>https://static-web-server.net</a-s><a-p>&quot; </a-p><a-at>title</a-at><a-p>=&quot;</a-p><a-s>static-web-server website</a-s><a-p>&quot;&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>svg</a-tg><a-p> </a-p><a-at>xmlns</a-at><a-p>=&quot;</a-p><a-s>http://www.w3.org/2000/svg</a-s><a-p>&quot; </a-p><a-at>width</a-at><a-p>=&quot;</a-p><a-s>100</a-s><a-p>&quot; </a-p><a-at>height</a-at><a-p>=&quot;</a-p><a-s>100</a-s><a-p>&quot; </a-p><a-at>viewBox</a-at><a-p>=&quot;</a-p><a-s>0 0 53.505 53.505</a-s><a-p>&quot;&gt;&lt;</a-p><a-tg>path</a-tg><a-p> </a-p><a-at>d</a-at><a-p>=&quot;</a-p><a-s>M161.49 84.99a.664.664 0 0 0-.38.149c-.081.07-.498.613-.927 1.207l-.778 1.079-.232.014c-.56.032-.46.11-1.354-1.054-.445-.58-.873-1.104-.95-1.165a.909.909 0 0 0-.345-.15c-.174-.03-.234-.02-.41.072a.873.873 0 0 0-.292.246c-.047.077-.327.672-.623 1.323-.594 1.309-.516 1.213-1.068 1.308l-.23.04-1.003-.874c-.552-.48-1.081-.914-1.177-.964-.327-.17-.8-.009-.946.321-.036.083-.198.719-.36 1.414-.163.695-.317 1.29-.345 1.324-.027.033-.188.12-.358.192l-.31.132-1.224-.707c-1.162-.67-1.239-.707-1.473-.697a.68.68 0 0 0-.403.12c-.273.193-.313.385-.354 1.719-.021.667-.042 1.285-.047 1.374-.008.14-.047.185-.317.362l-.309.203-1.296-.438c-1.449-.49-1.628-.519-1.883-.3-.084.073-.193.21-.243.306-.105.204-.102.244.172 1.87.104.612.183 1.136.176 1.164-.007.027-.122.159-.256.292l-.243.243-1.328-.172c-.73-.094-1.415-.16-1.52-.148a.717.717 0 0 0-.612.773c.011.105.232.756.49 1.446l.468 1.254-.18.292c-.1.16-.202.303-.227.316-.025.013-.553.054-1.173.093-1.646.103-1.685.109-1.86.258-.082.07-.19.207-.242.305-.157.3-.088.467.72 1.765l.722 1.161-.128.348c-.112.305-.147.354-.282.393-.084.025-.682.186-1.327.358-1.29.344-1.467.426-1.593.736a.677.677 0 0 0-.025.42c.044.23.097.296 1.014 1.275l.967 1.032-.058.332c-.033.182-.08.358-.106.392-.026.034-.571.32-1.211.636-.64.316-1.223.619-1.295.673-.275.208-.334.696-.117.974.059.076.606.498 1.216.937l1.108.8.008.274c.005.151.005.324 0 .383-.007.079-.277.312-1.042.9-.567.437-1.084.846-1.148.91a.876.876 0 0 0-.173.34c-.05.192-.046.252.024.415.045.105.146.24.223.302.078.061.687.358 1.353.66.899.408 1.22.576 1.244.652.018.056.058.224.088.372l.055.27-.897 1.03c-.494.566-.93 1.101-.971 1.189-.148.32.02.782.336.921.082.037.718.2 1.413.362.696.162 1.292.316 1.324.343.033.027.12.189.193.359l.132.309-.708 1.226c-.67 1.161-.706 1.238-.697 1.471.007.18.04.29.12.403.194.274.385.313 1.72.355.667.02 1.285.041 1.373.046.14.008.186.048.364.32l.203.309-.436 1.289c-.24.708-.44 1.361-.444 1.45-.01.218.052.365.221.525.29.273.31.273 1.713.05.693-.11 1.324-.219 1.402-.24.126-.034.169-.01.41.23l.27.268-.172 1.328c-.095.73-.16 1.413-.148 1.518.045.37.401.653.772.613.105-.01.756-.231 1.446-.49l1.255-.469.292.181c.16.1.302.202.315.227.013.025.055.553.094 1.174.102 1.645.108 1.684.258 1.859.07.082.207.19.305.242.299.156.467.088 1.766-.72l1.163-.721.352.13c.194.07.355.14.355.154.025.215.715 2.625.789 2.753a.795.795 0 0 0 .295.274c.163.083.235.09.449.048.244-.05.295-.09 1.286-1.019l1.033-.967.331.059c.182.032.359.079.393.105.034.026.32.571.636 1.211.316.64.62 1.223.673 1.295.217.288.714.336.994.097.082-.07.499-.613.927-1.206l.777-1.08.305-.019c.167-.01.343-.014.39-.006.047.008.448.488.891 1.067.444.579.846 1.088.893 1.133a.952.952 0 0 0 .288.147c.252.083.345.072.578-.068.221-.132.256-.196.91-1.64.268-.595.524-1.096.568-1.114.044-.018.215-.056.381-.083l.301-.05 1.004.873c.551.481 1.08.915 1.176.965.327.169.8.009.945-.321.037-.083.2-.719.362-1.414.162-.695.317-1.291.344-1.324.027-.033.188-.12.358-.192l.31-.133 1.225.707c1.161.67 1.238.707 1.471.698a.678.678 0 0 0 .403-.12c.275-.195.315-.385.355-1.72.02-.666.041-1.285.046-1.373.008-.14.049-.185.32-.364l.31-.203 1.294.439c1.448.491 1.626.52 1.882.3.084-.073.193-.21.243-.306.106-.204.102-.244-.172-1.87-.104-.612-.183-1.136-.176-1.163.007-.027.122-.16.255-.293l.243-.242 1.33.171c.73.094 1.414.161 1.519.148a.717.717 0 0 0 .612-.772c-.01-.105-.231-.756-.49-1.446l-.469-1.255.181-.292c.1-.16.202-.302.227-.315.025-.013.553-.055 1.174-.094 1.645-.103 1.684-.108 1.859-.257.082-.07.19-.208.242-.306.157-.3.088-.466-.72-1.764l-.722-1.162.128-.347c.112-.305.147-.354.282-.394.085-.025.681-.186 1.326-.358 1.29-.344 1.468-.426 1.594-.736a.676.676 0 0 0 .025-.42c-.044-.229-.096-.295-1.014-1.274l-.967-1.033.058-.33c.033-.183.08-.36.106-.393.026-.033.57-.318 1.208-.634.639-.315 1.221-.619 1.295-.674.29-.219.34-.715.1-.996-.07-.082-.613-.5-1.207-.927l-.054-.04-.55-1.873c.17-.139.347-.282.566-.45.579-.443 1.095-.854 1.148-.914a.957.957 0 0 0 .15-.326c.048-.186.044-.247-.026-.41a.905.905 0 0 0-.223-.3c-.078-.062-.685-.358-1.35-.66-.665-.301-1.223-.584-1.241-.628a2.895 2.895 0 0 1-.083-.38l-.05-.3.874-1.003c.48-.552.914-1.082.964-1.178.17-.328.009-.8-.324-.947-.085-.037-.72-.2-1.414-.362-.694-.162-1.288-.316-1.321-.342-.03-.025-.104-.164-.172-.316l-.12-.407.675-1.17c.67-1.162.706-1.238.697-1.472-.007-.178-.04-.29-.12-.403-.193-.273-.385-.313-1.72-.354-.666-.021-1.284-.042-1.372-.047-.14-.008-.186-.048-.365-.32l-.203-.309.44-1.295c.49-1.447.52-1.626.299-1.881a1.235 1.235 0 0 0-.306-.243c-.204-.106-.243-.102-1.869.172-.613.103-1.137.183-1.164.176-.027-.007-.159-.122-.292-.256l-.243-.242.172-1.33c.094-.73.16-1.414.147-1.519a.717.717 0 0 0-.772-.613c-.105.012-.756.232-1.446.49l-1.255.47-.292-.181c-.16-.1-.301-.202-.314-.227-.013-.025-.056-.554-.094-1.174-.103-1.645-.108-1.685-.258-1.86a1.236 1.236 0 0 0-.306-.242c-.299-.156-.467-.087-1.765.72l-1.16.723-.354-.13c-.195-.072-.357-.14-.357-.152-.025-.218-.715-2.63-.788-2.756a.802.802 0 0 0-.295-.274c-.163-.083-.235-.09-.449-.048-.244.05-.296.09-1.287 1.018l-1.033.968-.33-.059c-.183-.032-.36-.08-.394-.105-.034-.026-.32-.571-.635-1.211-.316-.64-.62-1.223-.674-1.295-.135-.18-.38-.266-.614-.247zm-.697 7.073.23.007c.772.027 2.37.305 3.543.618 1.461.39 2.871.954 4.201 1.67l-15.344 16.098 19.624-3.681-6.154 7.367 12.21-1.083c-.164 2.326-.664 4.402-1.554 6.473-.565 1.316-1.393 2.779-2.134 3.768l-.21.28-1.853-.083c-1.285-.056-1.935-.065-2.115-.028-.517.103-.958.5-1.118 1.001-.06.19-.101.723-.153 2.007-.038.961-.074 1.806-.08 1.877-.008.105-.077.168-.38.352-1.565.945-3.403 1.693-5.481 2.23-.636.163-3.37.523-4.096.538-2.105.044-4.413-.275-6.32-.874-.48-.15-.564-.193-.598-.3-.022-.068-.25-.884-.508-1.811-.342-1.232-.505-1.75-.607-1.92a1.507 1.507 0 0 0-1.317-.72c-.184.006-.814.162-2.052.51l-1.788.5-.267-.224c-.946-.794-2.086-2.03-2.935-3.183-1.563-2.121-2.609-4.365-3.314-7.108-.272-1.06-.592-3.89-.538-4.759.009-.152.061-.192 1.583-1.198 1.691-1.117 1.847-1.25 2.014-1.72.073-.205.08-.325.044-.657l-.046-.406-1.082-1.63-1.082-1.629.108-.264a23.32 23.32 0 0 1 .919-1.88 19.752 19.752 0 0 1 10.462-8.984c.31-.114.663-.235.782-.267l.219-.059 1.5 1.185c1.713 1.353 1.825 1.416 2.433 1.346.607-.07.703-.157 2.064-1.865z</a-s><a-p>&quot; </a-p><a-at>transform</a-at><a-p>=&quot;</a-p><a-s>translate(-132.667 -84.987)</a-s><a-p>&quot;/&gt;&lt;/</a-p><a-tg>svg</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text"><a-p>    &lt;/</a-p><a-tg>a</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"><a-p>  &lt;/</a-p><a-tg>div</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"><a-p>&lt;h1 class=&quot;sws-title&quot; align=&quot;center&quot;&gt;Static Web Server&lt;/h1&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"><a-p>&lt;</a-p><a-tg>h4</a-tg><a-p> </a-p><a-at>align</a-at><a-p>=&quot;</a-p><a-s>center</a-s><a-p>&quot;&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"><a-p>    A cross-platform, high-performance &amp; asynchronous web server for static files serving</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"><a-p>  &lt;/</a-p><a-tg>h4</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"><a-p>&lt;</a-p><a-tg>div</a-tg><a-p> </a-p><a-at>align</a-at><a-p>=&quot;</a-p><a-s>center</a-s><a-p>&quot;&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>https://github.com/static-web-server/static-web-server/actions/workflows/devel.yml</a-s><a-p>&quot; </a-p><a-at>title</a-at><a-p>=&quot;</a-p><a-s>devel ci</a-s><a-p>&quot;&gt;&lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>https://github.com/static-web-server/static-web-server/actions/workflows/devel.yml/badge.svg?branch=master</a-s><a-p>&quot;&gt;&lt;/</a-p><a-tg>a</a-tg><a-p>&gt; </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>https://hub.docker.com/r/joseluisq/static-web-server/</a-s><a-p>&quot; </a-p><a-at>title</a-at><a-p>=&quot;</a-p><a-s>Docker Image Version (tag latest semver)</a-s><a-p>&quot;&gt;&lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>https://img.shields.io/docker/v/joseluisq/static-web-server/2</a-s><a-p>&quot;&gt;&lt;/</a-p><a-tg>a</a-tg><a-p>&gt; </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>https://hub.docker.com/r/joseluisq/static-web-server/tags</a-s><a-p>&quot; </a-p><a-at>title</a-at><a-p>=&quot;</a-p><a-s>Docker Image Size (tag)</a-s><a-p>&quot;&gt;&lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>https://img.shields.io/docker/image-size/joseluisq/static-web-server/2</a-s><a-p>&quot;&gt;&lt;/</a-p><a-tg>a</a-tg><a-p>&gt; </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>https://hub.docker.com/r/joseluisq/static-web-server/</a-s><a-p>&quot; </a-p><a-at>title</a-at><a-p>=&quot;</a-p><a-s>Docker Image</a-s><a-p>&quot;&gt;&lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>https://img.shields.io/docker/pulls/joseluisq/static-web-server.svg</a-s><a-p>&quot;&gt;&lt;/</a-p><a-tg>a</a-tg><a-p>&gt; </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>https://crates.io/crates/static-web-server</a-s><a-p>&quot; </a-p><a-at>title</a-at><a-p>=&quot;</a-p><a-s>static-web-server crate</a-s><a-p>&quot;&gt;&lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>https://img.shields.io/crates/v/static-web-server.svg</a-s><a-p>&quot;&gt;&lt;/</a-p><a-tg>a</a-tg><a-p>&gt; </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>https://docs.rs/static-web-server</a-s><a-p>&quot; </a-p><a-at>title</a-at><a-p>=&quot;</a-p><a-s>static-web-server crate docs</a-s><a-p>&quot;&gt;&lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>https://img.shields.io/docsrs/static-web-server/latest?label=docs.rs</a-s><a-p>&quot;&gt;&lt;/</a-p><a-tg>a</a-tg><a-p>&gt; </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>https://github.com/static-web-server/static-web-server/blob/master/LICENSE-APACHE</a-s><a-p>&quot; </a-p><a-at>title</a-at><a-p>=&quot;</a-p><a-s>static-web-server license</a-s><a-p>&quot;&gt;&lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>https://img.shields.io/crates/l/static-web-server</a-s><a-p>&quot;&gt;&lt;/</a-p><a-tg>a</a-tg><a-p>&gt; </a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>href</a-at><a-p>=&quot;</a-p><a-s>https://discord.gg/VWvtZeWAA7</a-s><a-p>&quot; </a-p><a-at>title</a-at><a-p>=&quot;</a-p><a-s>Static Web Server Community on Discord</a-s><a-p>&quot;&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-p>      &lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>https://img.shields.io/discord/1086203405225164842?logo=discord&amp;label=discord</a-s><a-p>&quot;&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>    &lt;/</a-p><a-tg>a</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-p>  &lt;/</a-p><a-tg>div</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>&lt;/div&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-p>## </a-p><a-tt>Overview</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-p>**Static Web Server** (or **`SWS`** abbreviated) is a tiny and fast production-ready web server suitable to serve static web files or assets.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>It is focused on **lightness and easy-to-use** principles while keeping [high performance and safety](https://blog.rust-lang.org/2015/04/10/Fearless-Concurrency.html) powered by [The Rust Programming Language](https://rust-lang.org).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"><a-p>Written on top of [Hyper](https://github.com/hyperium/hyper) and [Tokio](https://github.com/tokio-rs/tokio) runtime, it provides [concurrent and asynchronous networking abilities](https://rust-lang.github.io/async-book/01_getting_started/02_why_async.html) and the latest HTTP/1 - HTTP/2 implementations.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>Cross-platform and available for `Linux`, `macOS`, `Windows`, `FreeBSD`, `NetBSD`, `Android`, `Docker` and `Wasm` (via [Wasmer](https://wasmer.io/wasmer/static-web-server)).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>![static-web-server running](https://github.com/static-web-server/static-web-server/assets/1700322/102bef12-1f30-4054-a1bc-30c650d4ffa7)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>## </a-p><a-tt>Features</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>- Built with [Rust](https://rust-lang.org), which focuses on [safety, speed and concurrency](https://kornel.ski/rust-c-speed).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"><a-p>- Memory-safe and significantly reduced CPU and RAM overhead.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p>- Blazing fast static files-serving and asynchronous powered by the latest [Hyper](https://github.com/hyperium/hyper/), [Tokio](https://github.com/tokio-rs/tokio) and a set of [awesome crates](https://github.com/static-web-server/static-web-server/blob/master/Cargo.toml).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>- Single __4MB__ (uncompressed) and fully static binary with no dependencies ([Musl libc](https://doc.rust-lang.org/edition-guide/rust-2018/platform-and-target-support/musl-support-for-fully-static-binaries.html)). Suitable for running on [any Linux distro](https://en.wikipedia.org/wiki/Linux_distribution) or [Docker container](https://hub.docker.com/r/joseluisq/static-web-server/tags).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>- Optional GZip, Deflate, Brotli or Zstandard (zstd) compression for text-based web files only.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"><a-p>- Compression on-demand via [Accept-Encoding](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Encoding) header.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>- Markdown content negotiation via [Accept](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept) header for serving `.md` files.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>- [Partial Content Delivery](https://en.wikipedia.org/wiki/Byte_serving) support for byte-serving of large files.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>- Optional [Cache-Control](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control) headers for assets.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-p>- [Termination signal](https://www.gnu.org/software/libc/manual/html_node/Termination-Signals.html) handling with [graceful shutdown](https://cloud.google.com/blog/products/containers-kubernetes/kubernetes-best-practices-terminating-with-grace) ability and grace period.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>- [HTTP/2](https://tools.ietf.org/html/rfc7540) and TLS support.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"><a-p>- [Security headers](https://web.dev/security-headers/) for HTTP/2 by default.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"><a-p>- [HEAD](https://tools.ietf.org/html/rfc7231#section-4.3.2) and [OPTIONS](https://datatracker.ietf.org/doc/html/rfc7231#section-4.3.7) responses.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>- Lightweight and configurable logging via [tracing](https://github.com/tokio-rs/tracing) crate.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>- Customizable number of blocking and worker threads.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"><a-p>- Optional directory listing with sorting and JSON output format support.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>- [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) with preflight requests support.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>- Basic HTTP Authentication.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"><a-p>- Customizable HTTP response headers for specific file requests via glob patterns.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>- Fallback pages for 404 errors, useful for Single-page applications.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"><a-p>- Run the server as a [Windows Service](&lt;https://docs.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2003/cc783643(v=ws.10)&gt;).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p>- Configurable using CLI arguments, environment variables or a TOML file.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p>- Default and custom error pages.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>- Built-in HTTP to HTTPS redirect.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"><a-p>- GET/HEAD Health check endpoint.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"><a-p>- Prometheus-compatible `/metrics` endpoint for traffic monitoring.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"><a-p>- Support for serving pre-compressed (Gzip/Brotli/Zstd) files directly from disk.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"><a-p>- Custom URL rewrites and redirects via glob patterns with replacements.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>- Virtual hosting support.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"><a-p>- Multiple index files.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text"><a-p>- Maintenance Mode functionality.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"><a-p>- Available as a library crate with opt-in features.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"><a-p>- First-class [Docker](https://docs.docker.com/get-started/overview/) support. [Scratch](https://hub.docker.com/_/scratch), latest [Alpine Linux](https://hub.docker.com/_/alpine) and [Debian](https://hub.docker.com/_/alpine) Docker images.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"><a-p>- Ability to accept a socket listener as a file descriptor for sandboxing and on-demand applications (e.g. [systemd](http://0pointer.de/blog/projects/socket-activation.html)).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"><a-p>- Cross-platform. Pre-compiled binaries for Linux, macOS, Windows, FreeBSD, NetBSD, Android (`x86/x86_64`, `ARM/ARM64`) and WebAssembly (via [Wasmer](https://wasmer.io/wasmer/static-web-server)).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text"><a-p>## </a-p><a-tt>Benchmarks</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"><a-p>&lt;</a-p><a-tg>img</a-tg><a-p> </a-p><a-at>title</a-at><a-p>=&quot;</a-p><a-s>SWS - Benchmarks April 2023</a-s><a-p>&quot; </a-p><a-at>src</a-at><a-p>=&quot;</a-p><a-s>https://raw.githubusercontent.com/static-web-server/benchmarks/master/data/2023-04/benchmark-2023-04.png</a-s><a-p>&quot; </a-p><a-at>width</a-at><a-p>=&quot;</a-p><a-s>860</a-s><a-p>&quot;&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"><a-p>For more details see [the benchmarks repository](https://github.com/static-web-server/benchmarks).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"><a-p>For feedback or questions feel free to reach us on [the discussions page](https://github.com/static-web-server/static-web-server/discussions).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>## </a-p><a-tt>Community</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text">[SWS Community on Discord](https://discord.gg/VWvtZeWAA7)</span></span></pre></div></div>
</main>
</body>
</html>
