# icloudpd web

icloudpd web is a self-hosted backup app. Self-hosted web interface for icloudpd (iCloud Photos Downloader) that provides a dashboard for configuring and monitoring multiple iCloud Photo Stream sync policies. It is open source and self-hosted, installable on Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/6529/icloudpd-web

## Description

Self-hosted web interface for icloudpd (iCloud Photos Downloader) that provides a dashboard for configuring and monitoring multiple iCloud Photo Stream sync policies. It securely stores Apple credentials via the system keyring, supports HEIC-to-JPG conversion, and sends download notifications through Telegram, Prowl, and other channels. Built for homelab users who want to back up photos and videos from multiple Apple devices to a central server without managing separate command-line configurations per device.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

43/100 (Fair), based on 4 of 5 factors.
- Maintained: 75 (last commit 8 days ago)
- Popular: 45 (168 GitHub stars)
- Easy to install: 15 (0 install platforms, install notes)
- Security check: 5 (4 serious findings, 6 minor, tests)

## Security check

4 serious findings: Uses anyio 4.8.0, which has a known critical vulnerability; Uses certifi 2024.12.14, which has a known critical vulnerability; Uses h11 0.14.0, which has a known critical vulnerability; Uses pillow 12.2.0, which has a known critical vulnerability.
Automated checks on commit 3f5e0b8, 7 Nov 2026. Not an audit.

## Links

- GitHub: https://github.com/AirswitchAsa/icloudpd-web
- Unraid: https://ca.unraid.net/apps?q=icloudpd-web&app=1gc6f9
- Docker Hub: https://hub.docker.com/r/spicadust/icloudpd-web

## Common questions

### What do I need to set before the first local run?

Generate and export ICLOUDPD_WEB_PASSWORD_HASH and ICLOUDPD_WEB_SESSION_SECRET before starting the server. You can then start it with your chosen host and port.

### Where does icloudpd-web store its data?

It uses ~/.icloudpd-web by default, and you can override the directory with --data-dir. Policies are stored as TOML files under policies/, and run logs are stored under runs/{policy}/{run_id}.log.

### How is the Docker image configured?

The Docker image is configured with HOST, PORT, and TOML_PATH environment variables. HOST defaults to 0.0.0.0 and PORT defaults to 5000.

### Can I manage several iCloud accounts or sync jobs in the UI?

It manages multiple icloudpd settings, called policies, through the web UI. Policies are stored as TOML files in the data directory.

### How can I watch a policy run after I start it?

You can stream live logs and progress via SSE while the policy run is active. Log files are also kept for run history.

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