Immich auf Synology NAS installieren

Ich möchte auf meinem Synology-NAS mit Docker IMMICH ans laufen bringen. IMMICH ist eine Selbstgehostete Foto- und Video-Management Web-Applikation, mit Smartpohone App - perfekt geeignet für ein gemeinsam genutzes Familienalbum.

1. Vorbereitungen

Auf dem NAS

Den Synology DiskStation-Manager (DSM) über den Browser aufrufen, und als Admin anmelden:

Das ist bei dir natürlich ein anderer Servername / IP Adresse.

sollte installiert sein:

  • Container-Manager
  • File Manager
  • Text Editor (optional)

2. Die Dateien herunterladen

Auf meinem Rechner:

Entweder mit wget, oder hierexternal link nach schauen - auf die Headline vom aktuellsten Release klicken, die Dateien docker-compose.yml und example.env suchen und einzeln runter laden.

wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O example.env https://github.com/immich-app/immich/releases/latest/download/example.env

3. Die Dateien anpassen

example.env

Damit sie vom Text-Editor geöffnet werden kann, ggfs. temporär umbenennen in example.env.txt.

Dann ein paar Anpassungen vornehmen:

  • UPLOAD_LOCATION=./library/
  • DB_DATA_LOCATION=./postgres
  • DB_PASSWORD=postgres

Theoretisch kann man einen beliebigen absoluten Pfad einstellen, wie zb. /volume1/immich-library/. Ich belasse es bei den relativen Pfaden, und ändere nur das Passwortexternal link .

# You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables

# The location where your uploaded files are stored
# /volume1/docker-data/immich/library/
UPLOAD_LOCATION=./library/
# The location where your database files are stored
DB_DATA_LOCATION=./postgres

# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
# TZ=Etc/UTC

# The Immich version to use. You can pin this to a specific version like "v1.71.0"
IMMICH_VERSION=release

# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD=postgres

# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

compose.yaml

In der datei compose.yaml ein paar Anpassungen vornehmen:

  • Den ganzen Abschnitt healthcheck: auskommentieren oder löschen.
  • Ändern: model-cache:/cache zu ./model-cache:/cache
  • Ganz unten volumes: model-cache: enternen.
#
# WARNING: Make sure to use the docker-compose.yml of the current release:
#
# https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
#
# The compose file on main may not be compatible with the latest release.
#

name: immich

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
    env_file:
      - .env
    ports:
      - '2283:2283'
    depends_on:
      - redis
      - database
    restart: always
    healthcheck:
      disable: false

  immich-machine-learning:
    container_name: immich_machine_learning
    # For hardware acceleration, add one of -[armnn, cuda, openvino] to the image tag.
    # Example tag: ${IMMICH_VERSION:-release}-cuda
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
    # extends: # uncomment this section for hardware acceleration - see https://immich.app/docs/features/ml-hardware-acceleration
    #   file: hwaccel.ml.yml
    #   service: cpu # set to one of [armnn, cuda, openvino, openvino-wsl] for accelerated inference - use the `-wsl` version for WSL2 where applicable
    volumes:
      - ./model-cache:/cache
    env_file:
      - .env
    restart: always
    healthcheck:
      disable: false

  redis:
    container_name: immich_redis
    image: docker.io/redis:6.2-alpine@sha256:eaba718fecd1196d88533de7ba49bf903ad33664a92debb24660a922ecd9cac8
    healthcheck:
      test: redis-cli ping || exit 1
    restart: always

  database:
    container_name: immich_postgres
    image: docker.io/tensorchord/pgvecto-rs:pg14-v0.2.0@sha256:90724186f0a3517cf6914295b5ab410db9ce23190a2d9d0b9dd6463e3fa298f0
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_DB: ${DB_DATABASE_NAME}
      POSTGRES_INITDB_ARGS: '--data-checksums'
    volumes:
      # Do not edit the next line. If you want to change the database storage location on your system, edit the value of DB_DATA_LOCATION in the .env file
      - ${DB_DATA_LOCATION}:/var/lib/postgresql/data
#    healthcheck:
#      test: >-
#        pg_isready --dbname="$${POSTGRES_DB}" --username="$${POSTGRES_USER}" || exit 1;
#        Chksum="$$(psql --dbname="$${POSTGRES_DB}" --username="$${POSTGRES_USER}" --tuples-only --no-align
#        --command='SELECT COALESCE(SUM(checksum_failures), 0) FROM pg_stat_database')";
#        echo "checksum failure count is $$Chksum";
#        [ "$$Chksum" = '0' ] || exit 1
#      interval: 5m
#      start_period: 5m
    command: >-
      postgres
      -c shared_preload_libraries=vectors.so
      -c 'search_path="$$user", public, vectors'
      -c logging_collector=on
      -c max_wal_size=2GB
      -c shared_buffers=512MB
      -c wal_compression=on
    restart: always

4. Verzeichnisse anlegen

Mit der Filestation die folgenden Verzeichnisse auf dem Synology anlegen:

  • /volume1/docker-data/immich
  • /volume1/docker-data/library
  • /volume1/docker-data/immich/model-cache
  • /volume1/docker-data/immich/postgres

Beachte: Bei mir liegen die die Docker-Daten getrennt von docker selbst in

  • /volume1/docker-data/

5. example.env umbenennen in .env

  • Die Datei example.env umbenennen in .env

6. Upload der Dateien

Die beiden Dateien über die Filestation auf das Synology NAS hochladen

  • in den Folder /volume1/docker-data/immich.

7. Starten

  • Container-Manager starten
  • Projekt -> erstellen
  • Pfad einstellen: /volume1/docker-data/immich
  • Vorhandene docker-compose verwenden
  • Weiter
  • KEIN Webportal via Webstation einrichten

Webbrowser aufrufen, und die URLs ausprobieren:

Freuen das es funktioniert :-)