icloudpd web

Self-hosted web interface for icloudpd (iCloud Photos Downloader) that provides a dashboard for configuring and monitoring multiple iCloud Photo Stream sync…

  • Backup
  • Cloud
  • Tools & Utilities
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
  • 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.

43/100 Fair

Maintained
75last commit 8 days ago
Popular
45168 GitHub stars
Easy to install
150 install platforms, install notes
Light to run
No data
Security check
54 serious findings, 6 minor, tests

Based on 4 of 5 factors.

GitHub stars
168
Open issues
2
Last commit
2026-11-12
Latest release
v2026.11.12
Activity
rising

Checked 2 days ago - source: GitHub (AirswitchAsa/icloudpd-web)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Docker Configuration Docker image (spicadust/icloudpd-web) is configured via environment variables: HOST (bind address, default 0.0.0.0), PORT (bind port, default 5000), and TOML_PATH (path to the configuration TOML file). source

Fetched 48 days ago - each note links to its source

Alternatives

No alternatives collected yet.

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.

Answers sourced from github.com, hub.docker.com

Community

Collected 48 days ago - public community threads