Zum Inhalt

Immich

Self-hosted Foto- und Video-Management mit automatischem Mobile-Backup, Gesichtserkennung und intelligenter Suche. GitHub

Zugriff
URL https://fotos.home.robinwerner.net
Port 2283
Netzwerk proxy_network, immich_internal
Traefik Ja

Container

Container Image Funktion
immich_server ghcr.io/immich-app/immich-server:v2.7.5 API-Server + Web-UI
immich_machine_learning ghcr.io/immich-app/immich-machine-learning:v2.7.5-openvino Gesichtserkennung, Smart Search (CLIP)
immich_redis valkey/valkey:8-alpine Cache + Job Queue
immich_postgres ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0 Datenbank mit Vektor-Suche

Konfigurationsbesonderheiten

  • OpenVINO ML-Beschleunigung: Intel iGPU via /dev/dri fuer Gesichtserkennung und CLIP-Encoding. Reduziert CPU-Last und beschleunigt ML-Jobs erheblich
  • VA-API Video-Transcoding: Aktivierung ueber Admin-Panel → Administration → Video Transcoding → Hardware Acceleration → VA-API
  • NFS-Storage: Fotos liegen auf dem UNAS Pro (/mnt/immich/). Thumbnails und encodierte Videos werden dort ebenfalls gespeichert
  • DB auf SSD: PostgreSQL liegt auf /mnt/ssd/ — NFS fuer die Datenbank ist nicht unterstuetzt und fuehrt zu Datenverlust
  • Kein Library-Watching ueber NFS: Stattdessen periodische Scans konfigurieren (bekanntes Performance-Issue mit NFS + chokidar)
  • Traefik Timeouts: Bei Upload-Problemen mit grossen Dateien respondingTimeouts auf 600s im websecure Entrypoint setzen
  • Version gepinnt: IMMICH_VERSION=v2.7.5 in .env — vor Updates Release Notes pruefen

Wichtige Pfade

Pfad Zweck
/mnt/immich/ Fotos + Videos (NAS, NFS)
/mnt/ssd/container-data/immich/postgres/ PostgreSQL-Datenbank (SSD)
/mnt/ssd/container-data/immich/model-cache/ ML-Modelle (SSD)

Backup

Die PostgreSQL-Datenbank enthaelt alle Metadaten (Alben, Gesichtstags, User, Einstellungen). Die Fotos selbst sind regulaere Dateien im Upload-Verzeichnis.

Datenbank-Dump:

docker exec immich_postgres pg_dumpall -U immich > /path/to/backup/immich-db-dump.sql

Wiederherstellen:

cat /path/to/backup/immich-db-dump.sql | docker exec -i immich_postgres psql -U immich -d immich

Update

cd /path/to/homeserver/immich

# 1. Release Notes lesen: https://github.com/immich-app/immich/releases
# 2. Version in .env anpassen
# 3. Images pullen und Container neu erstellen
docker compose pull
docker compose up -d

ToDo

  • NFS-Share auf UNAS Pro dauerhaft einrichten
  • Borgmatic-Backup fuer PostgreSQL-Dump integrieren
  • Dropbox-Fotos importieren (via immich-cli)