Docker - rejetto/hfs GitHub Wiki

HFS has an official Docker image on Docker Hub: rejetto/hfs.

Quick start

Run (persists config under /data, mounts a share, and uses host networking for real client IPs):

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 (so 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. See: https://github.com/rejetto/hfs/wiki/Reverse-proxy

Environment variables

This image does not add special environment variables. HFS itself supports configuration via env vars named HFS_* — see the main config documentation for details.