# docker-icloudpd | boredazfcuk | Knowledge Base | Instagit

An Alpine Linux container for the iCloud Photos Downloader command line utility 

GitHub Stars: 2.8k

Repository: https://github.com/boredazfcuk/docker-icloudpd

---

## Articles

### [How to Handle Unicode Characters in Filenames with the keep_unicode Option in docker-icloudpd](/boredazfcuk/docker-icloudpd/how-to-handle-unicode-characters-in-filenames)

Learn how to handle Unicode characters in filenames for docker-icloudpd using the keep_unicode option. Preserve non-ASCII characters like é ñ or emoji by setting keep_unicode true.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Use Single Pass Mode with Cron for Scheduled Synchronization in docker-icloudpd](/boredazfcuk/docker-icloudpd/how-to-use-single-pass-mode-with-cron)

Learn to schedule iCloud backups with docker-icloudpd using single pass mode and cron. Configure icloudpd.conf for efficient, single-cycle synchronizations and exits.

- Tags: how-to-guide
- Published: 2026-02-26

### [How the Synology Photos App Fix Triggers Indexing After Downloads in docker-icloudpd](/boredazfcuk/docker-icloudpd/how-does-synology-photos-app-fix-trigger-indexing)

Learn how the Synology Photos app fix triggers indexing for HEIC files downloaded by docker-icloudpd. Discover how timestamp manipulation ensures photos appear automatically.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Configure Webhook Notifications for Home Assistant or Other Systems with docker-icloudpd](/boredazfcuk/docker-icloudpd/how-to-configure-webhook-notifications)

Configure webhook notifications for Home Assistant or other systems with docker-icloudpd. Set notification type to webhook and define server and ID for real-time HTTP POST alerts from the container.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Use `--Force-Convert-All-HEICs` to Fix Incorrect JPEG Rotations in docker-icloudpd](/boredazfcuk/docker-icloudpd/how-to-use-force-convert-all-heics-to-fix-jpeg-rotations)

Fix incorrect JPEG rotations in docker-icloudpd by using the --Force-Convert-All-HEICs flag. This ensures ImageMagick re-converts HEIC files for proper orientation.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Safely Configure Auto-Delete and keep_icloud_recent Features in docker-icloudpd](/boredazfcuk/docker-icloudpd/how-to-safely-configure-auto-delete-and-keep_icloud_recent)

Safely configure auto-delete and keep_icloud_recent in docker-icloudpd. Learn to set features, define days, and bypass warnings with our guide.

- Tags: how-to-guide
- Published: 2026-02-26

### [How Sideways Copy Videos Works With video_path in docker-icloudpd](/boredazfcuk/docker-icloudpd/how-does-sideways-copy-videos-feature-work)

Learn how the sideways copy videos feature in docker-icloudpd duplicates or moves iCloud videos to your video_path directory. Preserve structure and permissions with ease.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Configure iCloud China (icloud.com.cn) in docker-icloudpd for Mainland China Users](/boredazfcuk/docker-icloudpd/how-to-configure-icloud-china-for-chinese-users)

Configure iCloud China icloud.com.cn for Chinese users with docker-icloudpd. Set environment variables ICLOUD_CHINA and AUTH_CHINA to route photos and authentication correctly.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Use the Telegram Bot for Remote Re-authentication When the iCloud Cookie Expires](/boredazfcuk/docker-icloudpd/how-to-use-telegram-bot-for-remote-re-authentication)

Learn to use the Telegram bot within docker-icloudpd to remotely re-authenticate iCloud and refresh your expired cookie without accessing the container shell.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Configure Download Interval and Avoid Apple API Throttling with docker-icloudpd](/boredazfcuk/docker-icloudpd/how-to-configure-download-interval-and-avoid-apple-api-throttling)

Learn how to configure download interval and avoid Apple API throttling with docker-icloudpd. Set download_interval to 12 hours or enable single_pass for external scheduling control.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Download Specific Albums or Shared Libraries with docker-icloudpd](/boredazfcuk/docker-icloudpd/how-to-download-specific-albums-or-shared-libraries)

Learn how to download specific albums or shared libraries with docker-icloudpd. Configure photo album or library variables to select only desired collections.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Manage User and Group IDs for Correct File Permissions in the docker-icloudpd Container](/boredazfcuk/docker-icloudpd/how-to-manage-user-and-group-ids-for-file-permissions)

Learn to manage user and group IDs in docker-icloudpd for correct file permissions. Set IDs in icloudpd.conf to sync with host UID/GID and ensure proper file ownership.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Enable Debug Logging in docker-icloudpd for Troubleshooting](/boredazfcuk/docker-icloudpd/how-to-enable-debug-logging-for-troubleshooting)

Troubleshoot docker-icloudpd issues by enabling debug logging. Learn how to set debug logging true in icloudpd conf or use the enable debugging flag for detailed insights.

- Tags: how-to-guide
- Published: 2026-02-26

### [How the docker-icloudpd Health Check Detects Cookie Expiration and Download Failures](/boredazfcuk/docker-icloudpd/how-does-the-health-check-detect-cookie-expiration-or-download-failures)

Learn how the docker-icloudpd health check detects cookie expiration and download failures by examining exit codes, error logs, and authentication cookie data.

- Tags: deep-dive
- Published: 2026-02-26

### [How to Set Up Multiple Notification Providers Simultaneously in docker-icloudpd](/boredazfcuk/docker-icloudpd/how-to-set-up-multiple-notification-providers)

Easily set up multiple notification providers like Prowl Pushover and Discord simultaneously for docker-icloudpd Learn how to overcome single provider limits with this guide

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Configure Photo Download Size in Docker iCloudPD: Original, Medium, Thumb, Adjusted, and Alternative](/boredazfcuk/docker-icloudpd/how-to-configure-photo-download-size)

Configure your docker icloudpd photo download size to original, medium, thumb, adjusted, or alternative. Easily control your iCloud photo downloads with this guide.

- Tags: how-to-guide
- Published: 2026-02-26

### [Docker-iCloudPD Command Line Options: Complete Guide to --Initialise, --Convert-All-HEICs, and More](/boredazfcuk/docker-icloudpd/what-are-available-command-line-options-for-docker-icloudpd)

Master docker-icloudpd command line options like Initialize and ConvertAllHEICs. Learn to manage iCloud photos and HEIC conversions efficiently.

- Tags: api-reference
- Published: 2026-02-26

### [How to Handle Large Photo Libraries with docker-icloudpd: Performance Optimization Guide](/boredazfcuk/docker-icloudpd/how-to-handle-large-photo-libraries-without-performance-issues)

Optimize docker-icloudpd for large photo libraries. Learn to handle thousands of images with skip_check=true and single_pass=true for improved performance. Avoid issues now.

- Tags: performance
- Published: 2026-02-26

### [How to Set Up Nextcloud Upload with Automatic Directory Creation for iCloud Photos](/boredazfcuk/docker-icloudpd/how-to-set-up-nextcloud-upload-with-automatic-directory-creation)

Easily set up Nextcloud upload for iCloud photos with automatic directory creation. This Docker container mirrors your photo structure by detecting changes and creating remote folders for seamless syncing. Configure with just f...

- Tags: how-to-guide
- Published: 2026-02-26

### [How the docker-icloudpd Failsafe Prevents Data Loss from Unmounted Volumes](/boredazfcuk/docker-icloudpd/how-does-the-failsafe-feature-prevent-data-loss-from-unmounted-volumes)

Learn how the docker-icloudpd failsafe prevents data loss by verifying volume mounts with a sentinel file before syncing data. Keep your iCloud data safe and secure.

- Tags: how-to-guide
- Published: 2026-02-26

### [How Telegram 2-Way Communication Enables Remote Sync and Re-Authentication in docker-icloudpd](/boredazfcuk/docker-icloudpd/how-does-telegram-2-way-communication-enable-remote-sync-and-re-authentication)

Learn how Telegram 2-way communication empowers remote sync and re-authentication for docker-icloudpd. Manage your iCloud data remotely with this innovative bot integration.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Convert HEIC Files to JPEG in docker-icloudpd: Quality Settings Guide](/boredazfcuk/docker-icloudpd/how-to-convert-heic-files-to-jpeg-and-specify-conversion-quality)

Convert HEIC to JPEG with docker-icloudpd. Set environment variables convert_heic_to_jpeg and jpeg_quality for custom ImageMagick conversion. Get high quality JPEGs.

- Tags: how-to-guide
- Published: 2026-02-26

### [How to Configure Folder Structure for Photo Downloads in docker-icloudpd (YYYY/MM/DD)](/boredazfcuk/docker-icloudpd/how-to-configure-folder-structure-for-photo-downloads)

Organize iCloud photos by year month and day using docker-icloudpd. Set the folder structure to YYYY/MM/DD in your icloudpd.conf file for automatic organization.

- Tags: how-to-guide
- Published: 2026-02-26

### [How MFA Cookie Authentication Works in docker-icloudpd: Lifecycle and Expiration Handling](/boredazfcuk/docker-icloudpd/how-does-mfa-cookie-authentication-work-and-what-causes-cookie-expiration)

Learn how docker-icloudpd MFA cookie authentication works. Understand cookie lifecycle and expiration handled by the X-APPLE-WEBAUTH-USER token stored in /config/.

- Tags: deep-dive
- Published: 2026-02-26