# Icloudpd

Icloudpd is a self-hosted backup app. 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. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/676/icloudpd

## Description

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.

## Health score

72/100 (Good), based on 4 of 5 factors.
- Maintained: 91 (last commit 27 days ago)
- Popular: 69 (2,966 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 75 (no serious findings)

## Links

- Docker Hub: https://hub.docker.com/r/boredazfcuk/icloudpd/
- Unraid: https://ca.unraid.net/apps/icloudpd-0aev9fo0cv6q60?q=icloudpd
- GitHub: https://github.com/boredazfcuk/docker-icloudpd

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/676/icloudpd), the self-hosted and open-source app directory.
