Dropbox
islamdiaa/dropbox-docker
latest
The newest release. Recommended.
stable
Same image as latest: the newest release.
development
Built from every change before it is released. Tested by CI, but may contain unfinished work.
https://hub.docker.com/r/islamdiaa/dropbox-docker
bridge
bash
false
https://forums.unraid.net/topic/197487-support-dropbox-docker-reliable-headless-dropbox-for-unraid-islamdiaadropbox-docker/
https://github.com/islamdiaa/dropbox-docker
https://github.com/islamdiaa/dropbox-docker/blob/main/README.md
Run the official Dropbox headless daemon in Docker. Built for reliability — handles large accounts (1M+ files), auto-restarts on crash, and stays up-to-date by pulling the latest Dropbox client on every startup.
Setup:
1. Install and start the container
2. Open the container log
3. Wait for a Dropbox URL to appear
4. Open the URL in your browser to link your account
5. Sync starts automatically
IMPORTANT: The Dropbox client does not support FUSE filesystems. You MUST use a direct disk path for your sync folder:
If your Dropbox share uses cache "No": /mnt/disk1/Dropbox
If your Dropbox share uses cache "Only": /mnt/cache/Dropbox
Do NOT use /mnt/user — it will not work. The container log warns you if it detects this.
If Dropbox asks you to link again after every restart, put the config on a direct path too (e.g. /mnt/cache/appdata/dropbox).
Problems? Check the container log first: it reports a sync folder Dropbox can't write to, and where your account actually syncs to.
Open the WebUI for a status page showing sync progress, account link, memory and restarts.
Features: status page, process supervision, Docker HEALTHCHECK, JSON status API, Prometheus metrics, telemetry crash fix, graceful shutdown, large account support.
By Islam ElTayar — https://itayar.com
Cloud: Backup:
http://[IP]:[PORT:8001]/
https://raw.githubusercontent.com/islamdiaa/dropbox-docker/main/unraid-template.xml
https://raw.githubusercontent.com/islamdiaa/dropbox-docker/main/icon.png
--restart unless-stopped --ulimit nofile=1048576:1048576 --add-host telemetry.dropbox.com:127.0.0.1
### 1.5.2 (2026-11-10)
- The WebUI entry now also appears for containers installed from an older template
- Status page: icon in the header and browser tab, links to the project and its author
### 1.5.1 (2026-11-09)
- New image tags: stable (same as latest: the newest release) and development (every change, before release)
- latest now only changes with a release or the monthly security rebuild
### 1.5.0 (2026-11-09)
- Fixed: every container update left an orphaned Docker volume (about 140 MB) behind
- Fixed: starting after an update walked the whole sync folder before Dropbox started
- New optional "Dropbox client" path keeps the client across updates
- Fixed: the sync folder was reset to 755 on every start, removing group/other write access
- Fixed: a hung or slow Dropbox status check could stall the watchdog or mark the container unhealthy
- Timezones like EST5EDT are accepted; warning when UID/GID is 0
- The Dropbox client is only downloaded over HTTPS
### 1.4.1 (2026-11-09)
- Security: includes Ubuntu's latest security updates (apt CVE-2026-109518)
### 1.4.0 (2026-10-20)
- Security: root never follows symlinks the Dropbox user could plant
- Startup no longer downloads 90 MB just to check the version, and has network timeouts
- Interrupted updates can't break the container any more
- Keeps Dropbox's own .dropbox.cache; less log noise from "isn't responding"
- Ownership repair at startup, on sync errors and daily, so array disks can sleep
### 1.3.0 (2026-10-11)
- New status page: open the WebUI to see sync progress, account link, memory and restarts
- Health check now turns unhealthy when Dropbox isn't running
- Restart count and Dropbox memory are reported correctly; new Prometheus metrics
- Ownership repair runs at low priority in the background
### 1.2.0 (2026-10-11)
- Fixed: account links but nothing syncs when Docker created the sync folder as root
- Fixed: Dropbox was force-killed on every stop or update with the template's polling interval
- Fixed: several Dropbox processes started without the KILL capability
- Fixed: crash loop on the very first start
- Warnings for /mnt/user paths; new Ownership repair setting
/mnt/disk1/Dropbox
/mnt/user/appdata/dropbox
99
100
America/New_York
true
600
20
30
full
true
17500
8001