Icloudpd

Docker container wrapping ndbroadbent's iCloud Photos Downloader, an Alpine Linux image for automatically syncing photos from multiple Apple devices to a…

  • Backup
  • Cloud
  • Downloaders
  • Tools & Utilities
Docker container wrapping ndbroadbent's iCloud Photos Downloader, an Alpine Linux image for automatically syncing photos from multiple Apple devices to a single self-hosted server. Supports HEIC-to-JPG conversion, secure credential storage via the system keyring, and notifications via Telegram, Discord, Pushover, Webhook, DingTalk, and other services. Aimed at homelab users who need a reliable, multi-device iCloud photo backup that runs on any Docker host.

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

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

Collected 48 days ago - public community threads