A fast, zero-dependency file server for your local network.
Share any folder over WiFi with a single command. Browse, navigate, and download files from any device — phone, tablet, or laptop — through a polished, dark-themed web interface.
FsHost is a single static binary that turns any folder into a website for your local network. Point it at a directory, and anyone connected to your WiFi can browse and download its contents from a browser — no accounts, no config files, no dependencies.
______ _ _ _
| ____| | | | | | |
| |__ ___| |__| | ___ ___| |_
| __/ __| __ |/ _ \/ __| __|
| | \__ \ | | | (_) \__ \ |_
|_| |___/_| |_|\___/|___/\__|
- Single binary, zero dependencies — statically compiled, nothing to install on the server.
- Automatic IP detection — picks your LAN address (
192.168.x.x) and prints ready-to-open URLs. - Dark, responsive web UI — animated, type-aware file icons, breadcrumbs, and a mobile-friendly layout.
- Fast and concurrent — pure Go
net/http, handles many simultaneous connections and resumeable downloads (HTTP Range). - Contained by design — serves only the directory you specify; path traversal is blocked at the filesystem level.
- Hidden-file aware — dotfiles are excluded from listings (but remain fetchable by direct URL if you know the name).
- Go 1.21+ (only needed to build from source)
- A network adapter with a routable IP (WiFi, Ethernet, VPN)
git clone https://github.com/n11kol11c/FsHost.git
cd FsHost
go build -o FsHost .go install github.com/n11kol11c/FsHost@latestThe version string defaults to 1.0.0 but can be injected:
go build -ldflags "-X main.version=2.3.1" -o FsHost .FsHost [flags]
Flags:
-dir string Directory to share (default ".")
-port int Port to serve on (default 8080)
# Share the current directory
FsHost
# Share a specific folder (supports ~)
FsHost -dir ~/Documents
# Serve on a custom port
FsHost -port 3000
# Share a build output for your team
FsHost -dir ./build -port 9090 📂 Serving: /Users/you/Documents
🌐 Network: http://192.168.1.23:8080
💻 Local: http://localhost:8080
⏱ Started: 2026-08-13 21:30:00
🛡 OS: darwin
✔ Server is live! Open the link above in any browser on your network.
Open the Network URL from any device on the same network to browse and download files. Press Ctrl+C to stop — FsHost shuts down gracefully and drains in-flight requests.
| Feature | Description |
|---|---|
| Breadcrumbs | Click any ancestor folder to jump back up the path |
| Parent link | A .. entry at the top of each listing |
| File icons | Emoji matched to extension — images, video, audio, archives, code, docs, and more |
| Sizes & dates | Human-readable sizes (KB / MB / GB) and last-modified timestamps |
| Direct download | Click any file to download it (with resume support) |
| Safe URLs | Filenames with spaces, #, ?, and other special characters are correctly escaped |
| Responsive | Optimized layout for phones, tablets, and desktops |
go build ./... # compile
go vet ./... # static checks
go build -o FsHost . && ./FsHost -dir ./testdata # run locallyThe web UI lives in theme/theme.go as a Go raw string; no build step or bundler is needed.
| OS | Notes |
|---|---|
| macOS | Works out of the box; may prompt for network permissions on first run |
| Linux | Works out of the box; use ports > 1024 to avoid needing root |
| Windows | Works out of the box; the firewall may ask to allow inbound access |
- FsHost has no authentication — anything on the network can read the shared folder. Use it only on networks you trust.
- It refuses to follow paths outside the shared root, even with crafted
..or encoded traversal attempts. - Symlinks inside the shared folder are followed like any file manager would.
- Do not expose FsHost to the public internet. It is designed for trusted local networks.
- Hidden files are hidden from listings but still reachable by direct URL; do not rely on this as access control.
Released under the MIT License.
Built with Go. No frameworks. No bloat. Just works.