Immich: Fotoverwaltung einfach auf Server installieren

Immich ist eine selbstgehostete, quelloffene Lösung zum Speichern und Verwalten von Fotos und Videos. Sie bietet eine Alternative zu Cloud-Diensten wie Google Photos und iCloud und setzt dabei auf Datenschutz und Benutzerkontrolle. In diesem Artikel zeige ich, wie Immich auf verschiedenen Servern installiert werden kann, sei es auf einem Synology NAS, einem Ugreen NAS oder einem anderen Computer.

Warum Immich?

In Zeiten, in denen Datenschutz immer wichtiger wird, bietet Immich die Möglichkeit, die Kontrolle über die eigenen Fotos und Videos zu behalten. Ohne Abhängigkeit von Drittanbietern können Bilder sicher im eigenen Netzwerk gespeichert und verwaltet werden. Immich bietet dabei eine einfache und intuitive Benutzeroberfläche, die es ermöglicht, Fotos und Videos zu organisieren und zu teilen.

Voraussetzungen

Immich kann mittels Docker auf den meisten Linux-Systemen installiert werden. Folgendes wird benötigt:

• Server mit Docker: Ein Server, auf dem Docker installiert ist.
• Hardware-Anforderungen: Empfohlen werden 6 GB RAM und 4 CPU-Kerne. In der Regel reichen jedoch auch 4 GB RAM und 2 CPU-Kerne aus.
• Speicherplatz: Ausreichend Speicherplatz für Fotos und Videos.
• Optional:
  • Reverse Proxy: Ein Reverse Proxy (z. B. Nginx Proxy Manager, Caddy, Traefik) für den externen Zugriff und die Nutzung einer Domain.
  • DNS-Server: Ein DNS-Server (z. B. Adguard Home, Pi-Hole, Technitium) für die interne Weiterleitung.
  • VPN-Server: Falls der Server nicht im eigenen Netzwerk steht, empfiehlt sich die Einrichtung eines VPN-Servers wie WireGuard oder OpenVPN.
  • SMTP-E-Mail-Adresse: Für Benachrichtigungen kann eine SMTP-Adresse genutzt werden, z. B. ein Shared-Webhosting-Tarif von Netcup.

Vorbereitung

Ordnerstruktur erstellen

Zunächst erstellen wir eine Ordnerstruktur für Immich auf dem Server. Diese Ordner werden für die Datenbank und die Speicherung der Fotos und Videos verwendet.

Benötigte Ordner:

• data
• db
• db-backup.

Beispiele:

cd ~
mkdir immich
cd immich
mkdir db db-backup data

/home/user/immich
├── db
├── db-backup
└── data

touch docker-compose.yml

/volume1/docker/
└── immich
    |── db
    └── db-backup

/volume2/dockerhdd/
└── immich
    └── data

/volume1/docker/
└── immich
    |── db
    |── db-backup
    └── data
# oder
/volume1/docker/
└── immich
    |── db
    └── db-backup

/volume2/dockerhdd/
└── immich
    └── data

Firewall

Um sicherzustellen, dass die erstellten Container miteinander kommunizieren können, empfiehlt es sich bei einer restriktiven Firewall entweder gleich den kompletten internen IP-Bereich freizugeben oder nach der Installation die von den Containern verwendeten IP-Adressen zu überprüfen. Andernfalls kann es vorkommen, dass die Container nicht miteinander kommunizieren können.

Installation

Immich benötigt folgende Docker-Container:

• Redis-Brocker
• PostgreSQL-Datenbank mit pgvecto.rs Erweiterung
• Immich-Server
• Immich-Machine (für maschinelles Lernen)

Docker Compose Datei

Wir brauchen zunächst die Containerbefehle, die wir Installation durchführen.

1
2networks:
3  internal:
4    name: internal
5    external: false
6  
7
8volumes:
9  model-cache:
10
11services:
12  redis:
13    container_name: immich_redis
14    image: redis:7-alpine
15    restart: unless-stopped
16    networks:
17      - internal
18    healthcheck:
19      test: redis-cli ping || exit 1
20
21  db:
22    container_name: immich_db
23    image: tensorchord/pgvecto-rs:pg16-v0.3.0
24    restart: unless-stopped
25    networks:
26      - internal
27    volumes:
28      - /volume1/docker/immich/db:/var/lib/postgresql/data
29    environment:
30      POSTGRES_DB: immich
31      POSTGRES_USER: immich
32      POSTGRES_PASSWORD: changeMeIamAPassword
33      POSTGRES_INITDB_ARGS: '--data-checksums'
34    healthcheck:
35      test: pg_isready --dbname='immich' --username='immich' || exit 1; Chksum="$$(psql --dbname='immich' --username='immich' --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
36      interval: 5m
37      start_interval: 30s
38      start_period: 5m
39    command:
40      [
41        'postgres',
42        '-c',
43        'shared_preload_libraries=vectors.so',
44        '-c',
45        'search_path="$$user", public, vectors',
46        '-c',
47        'logging_collector=on',
48        '-c',
49        'max_wal_size=2GB',
50        '-c',
51        'shared_buffers=512MB',
52        '-c',
53        'wal_compression=on',
54      ]
55
56  db_backup:
57    container_name: immich_db_backup
58    image: prodrigestivill/postgres-backup-local:16
59    restart: unless-stopped
60    environment:
61      POSTGRES_HOST: db
62      POSTGRES_CLUSTER: 'TRUE'
63      POSTGRES_USER: immich
64      POSTGRES_PASSWORD: changeMeIamAPassword
65      POSTGRES_DB: immich
66      SCHEDULE: "@daily"
67      POSTGRES_EXTRA_OPTS: '--clean --if-exists'
68      TZ: Europe/Berlin
69    volumes:
70      - /volume1/docker/immich/db-backup:/backups
71    depends_on:
72      - db
73    networks:
74      - internal
75
76  immich:
77    container_name: immich
78    image: ghcr.io/immich-app/immich-server:v1.118.2
79    restart: unless-stopped
80    depends_on:
81      - db
82      - redis
83    networks:
84      - internal
85      
86    ports:
87      - 2283:2283
88    volumes:
89      - /etc/localtime:/etc/localtime:ro
90      - /volume1/docker/immich/data:/usr/src/app/upload
91    environment:
92      DB_HOSTNAME: db
93      DB_USERNAME: immich
94      DB_DATABASE_NAME: immich
95      DB_PASSWORD: changeMeIamAPassword
96      TZ: Europe/Berlin
97    healthcheck:
98      disable: false
99
100  immich-machine-learning:
101    container_name: immich-machine-learning
102    image: ghcr.io/immich-app/immich-machine-learning:v1.118.2
103    restart: unless-stopped
104    depends_on:
105      - db
106      - redis
107    networks:
108      - internal
109    volumes:
110      - model-cache:/cache
111    environment:
112      DB_HOSTNAME: db
113      DB_USERNAME: immich
114      DB_DATABASE_NAME: immich
115      DB_PASSWORD: changeMeIamAPassword
116      TZ: Europe/Berlin
117    healthcheck:
118      disable: false
119    
📋

Die Images können angepasst werden, ich rate davon ab latest bzw. release zu nutzen, da es zu Problemen führen kann, wenn ein neues Image veröffentlicht wird, das nicht kompatibel ist. Insbesondere solange sich Immich in der Beta befindet, sollte man nicht einfach andere tags angeben. Man kann auf der Container-Seite gucken, welches Image momentan das neuste ist.

Reverse Proxy

Um Immich über eine Domain wie immich.domain.de erreichbar zu machen, richten wir in der Zwischenzeit einen Reverse Proxy ein.

client_max_body_size 50000M;
proxy_redirect off;

{
    acme_ca https://acme-v02.api.letsencrypt.org/directory
    email   mail@domain.com
}

immich.domain.de {
    @blocked not remote_ip private_ranges
    respond @blocked 403
    reverse_proxy 192.168.1.123:8010
    client_max_body_size 50G
}

{
    acme_ca https://acme-v02.api.letsencrypt.org/directory
    email   mail@domain.de
}

immich.domain.de {
    reverse_proxy 192.168.1.123:8010
    client_max_body_size 50G
}

Erster Login

Immich sollte nun unter der Domain oder der IP-Adresse des Servers (mit Port 2283) erreichbar sein.

Der erste Benutzer ist ein Admin-Benutzer. Dieser kann weitere Benutzer hinzufügen und die Einstellungen ändern.

Das Setup ist selbsterklärend. In der Verwaltung kann man nun neue Benutzer hinzufügen und diesen ein Speicherkontingent zuweisen. Die Benutzer können sich dann mit ihrer E-Mail-Adresse und einem Passwort anmelden.

Hat man eine SMTP-Adresse, kann man auch Benachrichtigungen einrichten. Das ist insbesondere dann nützlich, wenn mehrere Benutzer auf Immich zugreifen und Bilder teilen. Hier kann beispielsweise ein Webhosting Tarif von Netcup mit E-Mail Postfach genutzt werden. Die Kosten beginnen bei 2,17 € im Monat.

Apps

Immich bietet auch Apps für Android und iOS an. Diese können im jeweiligen App Store heruntergeladen werden. Die Apps sind kostenlos und ermöglichen es, Fotos und Videos direkt von den Geräten hochzuladen.

Immich App Android

Immich App iOS

Features:

• Automatischer Upload: Neue Fotos und Videos werden automatisch hochgeladen.
• Teilen und Zusammenarbeiten: Alben können mit Familie und Freunden geteilt werden.

Backup erstellen

Für ein vollständiges Backup sollten die Ordner db-backup (Datenbank) sowie data (Bilder und Videos) gesichert werden. Das lässt sich manuell machen. Alternativ auch automatisiert mit einem Skript oder einem Backup-Tool wie rsync oder Duplicati.

Ein Vorteil (und gleichzeitig Nachteil) von Immich liegt darin, dass die Bilder in einem normalen Dateisystem gespeichert werden. Das bedeutet falls irgendwas schief laufen sollte und Immich nicht mehr funktioniert, kann man die Bilder auch einfach so kopieren und auf einem anderen System wiederherstellen (vorausgesetzt die Bilder sind nicht gelöschte worden).

Fazit

Immich sollte nun laufen. Über Kommentare freue ich mich. Viel Spaß mit der Bildverwaltung!