Immich mit Docker Compose installieren: Schritt-für-Schritt-Anleitung für deinen eigenen Fotoserver

Fotos sind wertvolle Erinnerungen, und mit Immich kannst du sie ganz einfach selbst hosten, ohne auf Cloud-Dienste wie Google Photos angewiesen zu sein. Immich ist eine leistungsstarke Open-Source-Lösung für das Speichern, Organisieren und Teilen deiner Bilder – mit automatischer Synchronisation, KI-gestützter Gesichtserkennung und schnellen Suchfunktionen. In dieser Anleitung zeige ich dir, wie du Immich mit Docker Compose auf deinem eigenen Server installierst. So behältst du die volle Kontrolle über deine Fotos und kannst sie sicher auf deiner eigenen Hardware speichern.

Voraussetzungen

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

• Docker: Installiere Docker auf deinem System.
• Docker Compose: Stelle sicher, dass Docker Compose installiert ist.

Sollte beides nicht installiert sein, nutze doch meine Anleitung dazu.

Schritt-für-Schritt-Anleitung

1. Projektverzeichnis erstellen

Zuerst muss ein Verzeichnis erstellt werden um die Konfigurationsdateien abspeichern zu können.

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
Code-Sprache: JavaScript (javascript)

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
Code-Sprache: JavaScript (javascript)

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

nano .env
Code-Sprache: CSS (css)

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.ymlCode-Sprache: JavaScript (javascript)

(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.ymlCode-Sprache: JavaScript (javascript)

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
Code-Sprache: JavaScript (javascript)

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>
Code-Sprache: HTML, XML (xml)

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
Code-Sprache: CSS (css)

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";
}
Code-Sprache: PHP (php)

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.

Wer möchte kann sich auch noch eine Anleitung ansehen wie man Matomo Analytics installieren kann.