Send files from one device to many, in real time — private, peer-to-peer, with no size limit.
- Private: files go directly between browsers over encrypted WebRTC; the server never sees them.
- Any file size: files stream to disk as they arrive, so memory use stays flat no matter the size.
- Automatic resume: interrupted transfers reconnect and continue from where they stopped.
- One-to-many: share a room link or QR code and send to many devices at once.
- Works across networks: direct connection when possible, automatic relay when not.
- No installs or accounts: recipients just open a link; rooms can be password-protected.
- Self-hosted: a single Docker image you run yourself.
For quickly testing the app locally — not meant for production. Use Option B instead.
- Download
deploy/docker-compose.yml. - Start it:
docker compose up -dOpen http://localhost on the machine running Docker.
- Download
deploy/docker-compose-ssl.ymlanddeploy/Caddyfile. - Open
Caddyfileand replaceyourdomain.com(the first line) with your domain. Leave the rest of the file as it is. - Start it:
docker compose -f docker-compose-ssl.yml up -dOpen https://yourdomain.com.
Open these on your server's firewall:
| Port | Protocol | Purpose |
|---|---|---|
80 (HTTP) / 443 (HTTPS) |
TCP | Web interface |
3478 |
TCP + UDP | STUN/TURN, peer-to-peer connection setup |
50000–50100 |
UDP | TURN relay range, used when a direct connection isn't possible |
The 50000–50100 UDP range carries relayed traffic for the minority of connections that can't go direct, typically a peer behind symmetric NAT or a firewall that blocks UDP.
HTTP port. In docker-compose.yml, change the first number of the filesync port mapping. The second is the container's internal port; leave it as 80:
ports:
- "8080:80" # serve on http://localhost:8080HTTPS port. Keep Caddy on 443. For a non-standard external port, put your own reverse proxy in front, terminate TLS there, and forward to FileSync's internal HTTP port.
FileSync uses native WebRTC to transfer files directly between browsers, with no intermediate server in the data path. A WebSocket signaling server (served at /ws by the FileSync app itself) assists with connection setup only — relaying SDP offers/answers and ICE candidates between peers; once the peer-to-peer connection is established, file bytes flow directly between browsers and the server is no longer involved.
On the receiving side, the first save method the browser supports is used, in this order:
- File System Access API — streams to a file you pick. Desktop Chromium browsers (Chrome, Edge, Brave, Opera) over HTTPS.
- Service Worker — streams into a normal browser download. All modern browsers over HTTPS.
- Blob — buffers the entire file in memory before saving. Last resort; the only option over plain HTTP.
The first two require a secure context (HTTPS or localhost), so serving FileSync over HTTPS is recommended: it enables memory-safe transfers of any size.
Comic: xkcd #949 — "File Transfer" by Randall Munroe, licensed under CC BY-NC 2.5.
If you prefer the terminal, check out fsend — fast, private file sharing from your command line.
Released under the MIT License.