rejetto/hfs repository overview

⁠HFS (Docker)

Official image: rejetto/hfs

⁠Run

docker run -d --name hfs --network host \
  -v /path/to/hfs-data:/data \
  -v /path/to/share:/shares \
  rejetto/hfs:latest

⁠Notes

• The Docker image creates a default admin account with password please-change. Change it immediately.
• Config, data, and logs are stored under /data (keep /data persistent).
• If no config exists, the container creates one with a VFS entry for /shares.
• The default Docker config exposes /shares if it is mounted. Add other folders in the Admin panel.
• The container listens on port 80 by default.

⁠Real client IPs

You’ll only see real client IPs on Linux with host networking. On macOS/Windows (Docker Desktop) they stay masked unless you use a reverse proxy that forwards X-Forwarded-For and configure HFS to trust it.

More details: https://github.com/rejetto/hfs/wiki/Docker⁠