Docker Container: Immich¶

Kategorie: Photo Management\ Status: ✅ Aktiv\ Letzte Aktualisierung: 2026-04-24

Übersicht¶

Immich ist eine selbst-gehostete Foto- und Video-Backup-Lösung.

Docker Compose¶

Pfad: /usr/anatol/dockeruser/compose/immich/immich.yml\ Hinweis: compose.yml ist ein OMV-verwalteter Symlink → immich.yml. Änderungen NUR in immich.yml oder über OMV-Oberfläche (config.xml).

name: immich

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    volumes:
    1. ${UPLOAD_LOCATION}:/usr/src/app/upload
    1. /srv/dev-disk-by-uuid-b4fa7138-93d1-47e0-a1c3-efe83aeeb658/Fotos:/fotos:ro
    1. /etc/localtime:/etc/localtime:ro
    env_file:
    1. immich.env
    ports:
    1. 2283:2283
    depends_on:
    1. redis
    1. database
    restart: always

  immich-machine-learning:
    container_name: immich_machine_learning
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
    volumes:
    1. model-cache:/cache
    env_file:
    1. immich.env
    restart: always

  redis:
    container_name: immich_redis
    image: redis:6.2-alpine@sha256:b6124ab2e45cc332e16398022a411d7e37181f21ff7874835e0180f56a09e82a
    restart: always

  database:
    container_name: immich_postgres
    image: tensorchord/vchord-postgres:pg14-v0.4.3
    env_file:
    1. immich.env
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_DB: ${DB_DATABASE_NAME}
    volumes:
    1. pgdata:/var/lib/postgresql/data
    restart: always

volumes:
  pgdata:
  model-cache:

Environment File¶

Pfad: /usr/anatol/dockeruser/compose/immich/immich.env

UPLOAD_LOCATION=/srv/dev-disk-by-uuid-b4fa7138-93d1-47e0-a1c3-efe83aeeb658/ImmichUpload
IMMICH_VERSION=release
DB_PASSWORD=postgres
DB_HOSTNAME=immich_postgres
DB_USERNAME=postgres
DB_DATABASE_NAME=immich
REDIS_HOSTNAME=immich_redis

Volumes¶

Datenbank¶

VectorChord — Postgres Image Geschichte¶

VectorChord Migration (2026-04-08)¶

Postgres-Extension von pgvecto-rs auf VectorChord migriert.\ VectorChord ist der Nachfolger von pgvecto-rs: schneller, stabiler, weniger RAM-Verbrauch.

Migration läuft automatisch beim Start. Nach Abschluss: - clip_index: 108 MB - face_index: 100 MB

Wichtig: Nach Migration kein Downgrade unter v1.133.0 möglich.

Watchtower-Update-Problem (2026-04-24)¶

Watchtower aktualisierte immich-server auf v2.7.5. Diese Version benötigte vchord 0.4.3 — die .so-Bibliothek fehlte aber im damals aktiven Postgres-Image. Fehler: could not access file "$libdir/vchord": No such file or directory.

Lösung: Postgres Image auf tensorchord/vchord-postgres:pg14-v0.4.3 geändert (passend zur vchord 0.4.3, die die DB bereits hatte). Außerdem OMV config.xml dauerhaft aktualisiert + compose.yml als OMV-Symlink wiederhergestellt.

Wartung¶

# Alle Container neustarten
cd /usr/anatol/dockeruser/compose/immich
docker compose restart

# Logs anzeigen
docker logs immich_server --tail 100

# Datenbank Backup
docker exec immich_postgres pg_dumpall -U postgres | gzip > immich_backup_$(date +%Y%m%d).sql.gz

# OMV config.xml Postgres-Image prüfen
grep 'vchord\|pgvecto' /etc/openmediavault/config.xml

Backup¶

Wichtige Daten: - Fotos: /srv/.../Fotos (160GB+) - Upload: /srv/.../ImmichUpload - Datenbank: docker exec immich_postgres pg_dumpall -U postgres

Changelog¶

| Datum | Version | Änderung | | 2026-04-24 | v2.7.5 | Watchtower-Update: Postgres Image → tensorchord/vchord-postgres:pg14-v0.4.3 (vchord .so fehlte); OMV config.xml dauerhaft gefixt | | 2026-04-08 | v2.7.2 | Postgres auf VectorChord migriert (pgvecto-rs → vectorchord0.4.3); shm_size 128mb; Update v2.6.3 → v2.7.2 | | 2026-02-02 | - | Initiale Dokumentation |

← Zurück zur Docker-Übersicht