Icloudpd
Docker container wrapping ndbroadbent's iCloud Photos Downloader, an Alpine Linux image for automatically syncing photos from multiple Apple devices to a…
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.
72/100 Good
- Maintained
- 91last commit 27 days ago
- Popular
- 692,966 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 75no serious findings
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 53 days ago
- GitHub stars
- 2,966
- Open issues
- 73
- Last commit
- 2026-10-25
- Activity
- declining
Checked 12 days ago - source: GitHub (boredazfcuk/docker-icloudpd)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Initial Setup Run `sync-icloud.sh --Initialise` inside the container (or via `docker exec -it icloudpd`) to save your Apple ID password to the system keyring. Apple sends a confirmation code via SMS or 2FA to your device; enter it in the console to complete authentication. source
Fetched 37 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Do I need to initialize credentials manually after starting the container?
Yes, connect to the container and run sync-icloud.sh --Initialise. It saves the password to the system keyring and asks you to enter the Apple confirmation or 2FA code sent to your device.
Can it convert HEIC photos?
Yes, it has HEIC to JPG conversion capability.
What notifications can it send after syncing?
It can send Telegram, Prowl, Pushover, WebHook, DingTalk, Discord, openhab, IYUU, and WeCom notifications.
Can it back up several Apple devices to the same server?
The description says the maintainer uses it to sync the photo streams of all the iDevices in their house to a single server.
What does the error 'Apple iCloud is temporarily refusing to serve iCloudPD' mean during initialization?
It can appear while Apple is refusing to verify the password during account initialization, even when the password is believed to be correct.
Answers sourced from github.com, github.com
Community
- Need help with iCloudpd : r/selfhosted - Reddit (reddit)
- icloud-photos-downloader vs boredazfcuk/docker-icloudpd ... - Reddit (reddit)
- help with iCloud-PD (iPhone cloud -> qnap NAS) : r/selfhosted - Reddit (reddit)
- Immich and icloudpd : r/selfhosted - Reddit (reddit)
- iCloudPD - Autosync your iCloud Photos at Full Res : r/selfhosted - Reddit (reddit)
Collected 48 days ago - public community threads