michis0806/icloud-backup-docker repository overview

⁠iCloud Backup Docker

Back up your iCloud Drive and iCloud Photos automatically with a simple web interface.

⁠Features

• Multi-account support with 2FA (device push & SMS)
• iCloud Drive backup (folder selection or manual paths)
• iCloud Photos backup (including family library)
• Configurable sync policy per backup type: keep, delete, or archive removed files
• Scheduled backups via cron expressions
• Password-protected web UI
• Exclusion patterns (glob, paths)
• Etag caching for fast incremental backups
• Live progress, backup duration & built-in log viewer
• Pushover push notifications for backup errors and expiring tokens
• Multi-arch: linux/amd64 and linux/arm64

⁠Quick Start

# docker-compose.yml
version: "3.8"
services:
  icloud-backup:
    image: michis0806/icloud-backup-docker:latest
    container_name: icloud-backup
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./backups:/backups
      - ./config:/config
      - ./archive:/archive    # for sync policy "archive"
    environment:
      - TZ=Europe/Berlin
      - AUTH_PASSWORD=my-secure-password
      - SECRET_KEY=change-me-in-production

docker compose up -d

Open http://localhost:8080⁠ and log in.

⁠Environment Variables

⁠Volumes

⁠How It Works

1. Add account – Enter your Apple ID and app-specific password, confirm 2FA (device push or SMS)
2. Configure – Select folders/photos, set exclusions, choose schedule and sync policy
3. Back up – Run manually or let the scheduler handle it

⁠Sync Policy

For each backup type (Drive / Photos) you can choose independently what happens when files are deleted in iCloud:

• Keep – local files remain untouched (default for Photos)
• Delete – local files are removed (default for Drive)
• Archive – files are moved to /archive, preserving the folder structure

Session tokens are cached so you don't need to re-authenticate on every run. 2FA tokens typically last ~2 months.

⁠Synology NAS

Works great on Synology NAS via Container Manager, SSH, or Portainer. See the full documentation⁠ for detailed Synology setup instructions.

⁠Links

• GitHub Repository⁠
• Create an App-Specific Password⁠

⁠[Unreleased]

⁠[0.14.0] - 2026-10-02

⁠Added

• Französisch, Italienisch und Spanisch: UI_LANGUAGE akzeptiert jetzt zusätzlich fr, it und es. Die Kataloge wurden maschinell aus dem englischen und deutschen Katalog übersetzt; Verbesserungen von Muttersprachlern sind willkommen. Baut auf der Übersetzungsgrundlage von Jeremy Mikkelsen (0.13.0) auf.