Installation von Immich mit Docker Compose

Immich ist eine leistungsstarke Open-Source-Plattform zum Verwalten von Fotos und Videos. Mit der offiziellen Anleitung kannst du Immich unkompliziert mit Docker Compose installieren. Hier erkläre ich dir Schritt für Schritt, wie das funktioniert.

Installation von Immich mit Docker Compose

Voraussetzungen

Bevor du loslegst, stelle sicher, dass folgende Voraussetzungen erfüllt sind:


Schritt-für-Schritt-Anleitung

1. Projektverzeichnis erstellen

Erstelle ein Verzeichnis, in dem die Konfigurationsdateien gespeichert werden:

mkdir /opt/immich-docker && cd /opt/immich-docker

2. Docker-Compose-Datei herunterladen

Lade die erforderliche docker-compose.yml-Datei von der offiziellen Immich-Website:

curl -o docker-compose.yml https://raw.githubusercontent.com/immich-app/immich/main/docker/docker-compose.yml

3. Umgebungsvariablen konfigurieren

Die Docker-Compose-Datei benötigt eine .env-Datei, um Umgebungsvariablen zu setzen. Du kannst eine Vorlage herunterladen:

curl -o .env https://raw.githubusercontent.com/immich-app/immich/main/docker/.env.sample

Passe die Datei nach deinen Bedürfnissen an. Öffne sie mit einem Texteditor:

nano .env

Wichtige Variablen sind unter anderem:

  • DATABASE_USER und DATABASE_PASSWORD: Benutzername und Passwort für die PostgreSQL-Datenbank.
  • TZ=Etc/UTC: Diese auf Europe/Berlin stellen.

(Optional) hwaccel.transcoding.yml

Diese Datei wird genutzt, um Hardwarebeschleunigung (Hardware Acceleration, kurz HW Acceleration) für die Transkodierung von Videos zu aktivieren. Dabei wird die Verarbeitung von Videodateien (wie das Umwandeln in ein kompatibles Format oder das Reduzieren der Dateigröße) durch die GPU deines Systems beschleunigt, anstatt ausschließlich die CPU zu belasten.

wget -O hwaccel.transcoding.yml https://github.com/immich-app/immich/releases/latest/download/hwaccel.transcoding.yml

(Optional) hwaccel.ml.yml

Diese Datei wird verwendet, wenn keine Hardwarebeschleunigung verfügbar ist. Stattdessen wird die Videoverarbeitung vollständig von der CPU übernommen.

wget -O hwaccel.ml.yml https://github.com/immich-app/immich/releases/latest/download/hwaccel.ml.yml

4. Docker-Compose-Dienste starten

Starte Immich und die zugehörigen Dienste mit Docker Compose:

docker-compose up -d

5. Status prüfen

Überprüfe, ob die Dienste ordnungsgemäß laufen:

docker-compose ps

6. Zugriff auf Immich

Rufe Immich in deinem Browser auf:

http://localhost:2283

Falls du auf einem Server arbeitest, ersetze localhost mit der IP-Adresse deines Servers.


Tipps zur Verwaltung

Dienste neustarten:

docker-compose restart

Logs anzeigen: Sieh dir die Logs eines bestimmten Dienstes an:

docker-compose logs <dienstname>

Nginx auf dem Host einrichten

Damit auch alles von ausserhalb erreichbar ist, wird nun Nginx eingerichtet. Zuerst müssem die DNS Einstellungen für die Domain vorhanden sein. Ist das erledigt, dann muss noch folgendes getan werden.

certbot certonly --nginx -d immich.domain.tld

Danach wird eine Nginx Konfiguration angelegt.

server {
    # Redirect all HTTP requests to HTTPS
    listen 80;
    listen [::]:80;
    server_name immich.domain.tld;

    location / {
        return 301 https://$server_name$request_uri;
    }
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name immich.domain.tld;

    # Path to the SSL certificates from Let's Encrypt
    ssl_certificate /etc/letsencrypt/live/immich.domain.tld/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/immich.domain.tld/privkey.pem;

    # SSL options
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers on;
    ssl_ciphers HIGH:!aNULL:!MD5;

    # allow large file uploads
    client_max_body_size 50000M;

    # Set headers
    proxy_set_header Host              $http_host;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;

    # enable websockets
    proxy_http_version 1.1;
    proxy_set_header   Upgrade    $http_upgrade;
    proxy_set_header   Connection "upgrade";
    proxy_redirect     off;

    # set timeout
    proxy_read_timeout 600s;
    proxy_send_timeout 600s;
    send_timeout       600s;

    location / {
        proxy_pass http://127.0.0.1:2283;
    }

    # Optionally add security headers
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Content-Type-Options nosniff;
    add_header X-Frame-Options DENY;
    add_header X-XSS-Protection "1; mode=block";
}

Nun die Seite aktivieren und Nginx neu starten.

ln -s /etc/nginx/sites-available/immich /etc/nginx/sites-enabled/immich
service nginx reload

Mit diesen Schritten hast du Immich erfolgreich installiert und konfiguriert. Für weitere Anpassungen und Updates empfehle ich dir, die offizielle Dokumentation zu konsultieren.


Ich nutze seit mehr als einem Jahr Immich, dies hat Google Fotos und Apple Photos komplett ersetzt, ebenso der Upload in meine Nextcloud. Dieser geschieht nur noch über die Immich App für iOS bzw. Android.