ICloud

iCloud Drive Docker is a containerized tool that creates a local mirror of your iCloud Drive documents and Photos, keeping the copy automatically up to date…

  • Backup
  • Cloud
  • Downloaders
  • Home Automation
  • Tools & Utilities
iCloud Drive Docker is a containerized tool that creates a local mirror of your iCloud Drive documents and Photos, keeping the copy automatically up to date for self-hosted backups.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

75/100 Good

Maintained
100last commit 25 days ago
Popular
661,900 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 47 days ago

GitHub stars
1,900
Open issues
8
Last commit
2026-10-26
Latest release
v2.3.0
License
BSD-3-Clause
Activity
declining

Checked 20 days ago - source: GitHub (mandarons/icloud-drive-docker)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the downloader with pip If Python is missing, install it first, then run `pip install icloudpd` (or `pip install icloudpd --user` on Windows) using pip, Python's package installer. This installs the downloader, and on Windows you should add the scripts folder pip prints to your system PATH (the list of folders Windows checks for commands) so the command can be found. source
  • Tell it your account and photo folder Run something like `icloudpd --username your@email --directory /photos --watch-with-interval 3600` after installing. This tells it which iCloud account to use, where to save the photos, and to keep checking for new pictures. source
  • If using Docker, check the help first If you're using Docker (a container tool), run `docker run -it --rm icloudpd/icloudpd:latest icloudpd --help` to pull the image and see its options. This helps you choose the right username, folder, and watch settings before starting a real download. source
  • Docker installation Use the Docker image mandarons/icloud-drive from Docker Hub; the project was previously named icloud-drive-docker. source

Fetched 37 days ago - each note links to its source

Alternatives (12)

  • Dropbox - Dropbox is a containerized client that runs the official Dropbox sync agent on a self-hosted server, keeping a local folder backed up and s…
  • Ente Locker - Ente Locker is a secure vault for life’s essentials - your most important documents and credentials - protected with end-to-end encryption.
  • Filen - Filen is a cutting-edge cloud storage provider that offers client-side, end-to-end, zero-knowledge encryption.
  • Google Drive - Cloud service for file storage and sync, integrated with Google Docs suite, facilitating collaboration and offering scalable storage soluti…
  • Koofr - Koofr is a safe, secure and simple way to store, backup and share your documents, photos, videos and more.
  • MEGA - Cloud-storage service with end-to-end encryption, selective synchronization, and shared folders without ads.
  • Microsoft OneDrive - Access, edit, and share your files across devices with 5 GB free storage.
  • Nextcloud - Nextcloud is a self-hosted, open-source file and content collaboration platform that stores, syncs, and shares your files so you can access…
  • Proton Drive - Emphasizes privacy with end-to-end encryption, Proton Drive safely stores, synchronizes, and shares files across devices via web and mobile…
  • Pydio - Pydio is the mature alternative to Dropbox and Box.com, to build your own box, on your own servers.
  • Seafile - Seafile is an open-source, self-hosted cloud storage and file sync platform that lets individuals and teams store, sync, share, and organiz…
  • Skykeep - Skykeep keeps your iCloud on your own computer and syncs it quietly in the background.

Checked 51 days ago - source: AlternativeTo

Common questions

Does this container upload local files back to iCloud?

No. It only downloads files from the iCloud server, and it does not upload local files to the server yet.

Do I need to publish port 8080?

No, the 8080 port is only for the optional web UI. Remove the port mapping if you are not enabling app.web_ui.enabled in config.yaml.

How do I log in when the password is not in the environment or 2FA is required?

Run a docker exec command into the container with icloud --username=... --session-directory=/config/session_data and follow the authentication prompts. For China server users, add --region=china to that command.

What volumes should I mount to keep the download and auth state?

Mount persistent host directories to /icloud for downloaded files and /config for the configuration file and session data.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads