Ultra-lightweight HTTP file server for directory browsing and local development

Size: 37kb (Musl+strip+upx)

Speed: 12x faster than Python's http.server

Usecase: Testing, development, quick file sharing, embedded, minimal docker

Features:

• Directory browsing with minimal/modern CSS styling
• Mobile friendly
• Common MIME types handling
• Directory traversal protection
• Hidden file option
• Fork-based concurrency
• Fully self contained (statically linked)
• Memory footprint: 240 kB

Docker image size: 35.7KiB Memory usage: 496KiB

docker run -p 0.0.0.0:8000:8000 -v /path/to/files/:/data alsca183/yaths

• musl-gcc (musl-tools package)
• upx (optional, for compression)

sudo apt install musl-tools upx  # Debian/Ubuntu
# or
sudo dnf install musl-gcc upx    # Fedora

git clone https://github.com/al-sca/yaths
cd yaths
musl-gcc -static -Os -s -o yaths yaths.c
strip yaths
upx --best --lzma yaths
./yaths

brew install musl-cross upx
musl-gcc -static -Os -s -o yaths yaths.c
strip yaths
upx --best --lzma yaths
./yaths

# Build with gcc
gcc -static -Os yaths.c -o yaths
./yaths

Be sure that you ran "termux-setup-storage" before serving files

# Run it in /home
gcc yaths.c -o yaths
./yaths --dir ~/storage

./yaths -h
Usage: ./yaths [OPTIONS] [PORT]

YaTHS - Yet another Tiny HTTP-Server

Options:
  --port PORT        Set port number (default: 8000)
  --dir PATH         Set directory to serve (default: current dir)
  --show-hidden, -a  Show hidden files (files starting with .)
  --help, -h         Show this help message

Examples:
  ./yaths                      # Serve current directory on port 8000
  ./yaths 3000                 # Serve on port 3000
  ./yaths --port 8080          # Serve on port 8080
  ./yaths --dir /var/www       # Serve /var/www directory
  ./yaths -a --port 3000       # Show hidden files on port 3000

YaTHS vs python http-server

*Benchmarked with wrk (10s, 4 threads, 100 connections)

• VmSize: 240kB - Total virtual memory
• VmRSS: 0kB - Physical memory
• VmData: 8kB - Data segment
• VmStk: 136kB - Stack space allocated
• VmExe: 40kB - Executable code
• VmLib: 24kB - Musl libc

# Build
docker build -t yaths .
# Run
docker run -p 0.0.0.0:8000:8000 -v /path/to/files/:/data yaths

Development Use Only - YaTHS is designed for local development and testing. Not recommended for production use:

• No HTTPS/TLS support
• No HTTP/2 or HTTP/3
• No authentication
• No rate limiting
• No compression
• No caching headers
• Minimal hardening

MIT License