# svenstaro/miniserve

🌟 For when you really just want to serve some files over HTTP right now!

Repository: https://github.com/svenstaro/miniserve
Canonical: https://ross.abutalabs.com/products/miniserve
Language: Rust
License: MIT
License Family: permissive
Topics: serve, http-server, server, static-files, cli, command-line, command-line-tool
Last push: 2026-08-01T02:55:24+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 95, release rhythm 66, longevity 100
- inputs: {"age_days": 3051, "days_push": 32, "days_rel": 147, "gap_med": 81, "n_releases_24m": 8}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7817, forks 398 (observed 2026-08-28T04:10:05.243015+00:00)

## What it is
miniserve is a small, self-contained Rust CLI tool that serves files and directories over HTTP with a single command. It supports authentication, TLS, custom headers, SPA serving, and file uploads without any configuration.

## Use cases
- quickly share a directory over http
- serve static files from the command line
- temporarily expose a folder on the local network
- serve a single file for download
- host a single page application locally
- serve files with basic auth password protection
- serve files over https with tls

## When to choose
- you need to serve files over HTTP immediately with zero configuration
- you want a single portable binary instead of configuring nginx or python http.server
- you need quick ad-hoc file sharing with optional auth and TLS
- you want a built-in file browser UI with upload support

## When to avoid
- you need a production-grade web server with reverse proxying, load balancing, or caching
- you need complex routing, middleware, or dynamic server-side logic
- you want long-running infrastructure-grade static hosting with CDN integration

## Facets
- artifact type: cli-tool
- maturity: active
- function: http-server, file-upload, auth, cli
- domain: developer-tools, web-development, self-hosted
- platform: cli, cross-platform, windows, rust
- tags: static-file-server, file-sharing, quick-http-server, single-binary, tls, rust, command-line, linux, macos, docker

## Member repositories
- svenstaro/miniserve (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:05.243015+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:34:09.951350+00:00, confidence not recorded.
  - readme: https://github.com/svenstaro/miniserve (fetched 2026-08-28T04:10:05.243015+00:00, sha 21c4138c7ea8)
  - registry_crates: https://crates.io/api/v1/crates/miniserve (fetched 2026-08-29T08:30:39.981561+00:00, sha cbdf9e1e4374)
- Data as of 2026-08-30T08:39:29.467469+00:00.