© 2026 Hedgehog Software, LLC

TwitterGitHubDiscord
More
CommunitiesDocsAboutTermsPrivacy
Search
Star
Setup for Free
ImmichI
Immich•5mo ago•
148 replies
Sips_ real guy best guy

iCloudPD As External Library

I'm kinda struggling to get my imported library via icloudpd connected to Immich... Is this the article to do so? The new path I enter keeps crashing my Docker container (being run in Synology DSM). https://docs.immich.app/guides/external-library

I think the problem is I just don't understand the line you add after the {UPLOAD_LOCATION}. I'd say I'm pretty noobish but I'm determined to get this working. Thank you in advance!

This is the first chunk of its docker-compose.yml:
services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    # extends:
    #   file: hwaccel.transcoding.yml
    #   service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding
    volumes:
      # Do not edit the next line. If you want to change the media storage location on your system, edit the value of UPLOAD_LOCATION in the .env file
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      - /etc/localtime:/etc/localtime:ro
      - /volume1/homes/MrNicholas/icloudpd_backup:/volume1/homes/MrNicholas/icloudpd_backup
    env_file:
      - .env
services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    # extends:
    #   file: hwaccel.transcoding.yml
    #   service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding
    volumes:
      # Do not edit the next line. If you want to change the media storage location on your system, edit the value of UPLOAD_LOCATION in the .env file
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      - /etc/localtime:/etc/localtime:ro
      - /volume1/homes/MrNicholas/icloudpd_backup:/volume1/homes/MrNicholas/icloudpd_backup
    env_file:
      - .env


Here's a relevant snippet from my .env:
# The location where your uploaded files are stored
UPLOAD_LOCATION=/volume1/homes/MrNicholas/immich-backup

# The location where your database files are stored. Network shares are not supported for the database
DB_DATA_LOCATION=/volume1/docker/immich-app/postgres
# The location where your uploaded files are stored
UPLOAD_LOCATION=/volume1/homes/MrNicholas/immich-backup

# The location where your database files are stored. Network shares are not supported for the database
DB_DATA_LOCATION=/volume1/docker/immich-app/postgres


I've also attached a screenshot of the first run's log.
immich-crash.png
External Library | Immich
This guide walks you through adding an External Library.
ImmichJoin
A place to hang out, get support, discuss Immich, get announcements about releases and anything else going on.
36,590Members
Resources

Similar Threads

Was this page helpful?
Recent Announcements
Next page

Similar Threads

External library as main?
ImmichIImmich / help-desk-support
6mo ago
external library
ImmichIImmich / help-desk-support
7mo ago
Sharing external Librarys
ImmichIImmich / help-desk-support
4mo ago
External Library Issue
ImmichIImmich / help-desk-support
4mo ago