# Static Web Server

Static Web Server is a fast, cross-platform, single-binary web server for serving static websites and files.

Canonical page: https://ourlocalhost.com/app/8789/static-web-server

## Description

Static Web Server is a fast, cross-platform, single-binary web server for serving static websites and files. Written in Rust with no runtime dependencies, it gives homelab users a lightweight, reliable way to publish landing pages, documentation sites, or static assets from any computer.

## Platform availability

Available on 1 of 10 platforms: Any server.

## Desktop and other devices

Other (web,freebsd).

## Health score

76/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 0 days ago)
- Popular: 68 (2,415 GitHub stars)
- Easy to install: 35 (2 install platforms, install notes)
- Light to run: 50 (2 GB minimum RAM)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Official website: https://static-web-server.net/
- GitHub: https://github.com/static-web-server/static-web-server
- desktop: https://github.com/static-web-server/static-web-server/releases/latest
- Documentation: https://static-web-server.net/v3/

## Common questions

### Should I use v3 for a production instance?

No; the README says v3 is upcoming and in development, while v2 LTS should be used for production.

### Is a config file required to run SWS?

No. You can point it at a folder with zero configuration, or customize it through CLI flags, environment variables, or a TOML config file.

### Does it support compression for client delivery?

Yes. It can compress text-based files on the fly using Gzip, Deflate, Brotli, or Zstandard, and it can also serve pre-compressed .br, .gz, and .zst files directly.

### Can I get structured logs to a file?

Yes. It supports structured JSON logging via --log-format and file-based log output via --log-file.

### Does directory listing include download access?

Yes. Optional directory listing can output HTML and JSON, and it also includes a .tar.gz download.

### Does it have built-in authentication?

Yes. Basic Authentication is included in the v3 feature list.

---
Source: Our Local Host (https://ourlocalhost.com/app/8789/static-web-server), the self-hosted and open-source app directory.
