Immich: Private Foto-Cloud unter Ubuntu 24.04 LTS Server installieren

Immich ist eine selbstgehostete Alternative zu Google Photos, die in den letzten Jahren immer mehr an Beliebtheit gewonnen hat. Das Open-Source-Projekt ermöglicht es dir, deine Fotos und Videos in einer eigenen, privaten Cloud zu speichern, zu organisieren und zu teilen – ohne dabei die Kontrolle über deine Daten abzugeben.

Anders als bei kommerziellen Diensten behältst du bei Immich die volle Kontrolle über deine persönlichen Erinnerungen. Die Software bietet viele Funktionen, die du von Google Photos kennst: automatische Gesichtserkennung, Standorterfassung, Albumorganisation und eine intuitive Suche. Zusätzlich kannst du mit der mobilen App (verfügbar für Android und iOS) Fotos automatisch hochladen, ähnlich wie bei kommerziellen Cloud-Diensten.

Warum solltest du Immich verwenden?

Es gibt mehrere überzeugende Gründe:

┌─ Datenschutz: Deine Fotos bleiben auf deinem eigenen Server und werden nicht von Dritten analysiert
├─ Keine Abonnementkosten: Nach der einmaligen Einrichtung fallen keine monatlichen Gebühren an.
├─ Unbegrenzter Speicherplatz: Du bist nur durch deinen verfügbaren Festplattenspeicher limitiert.
└─ Volle Kontrolle: Du entscheidest über Backups, Updates und Sicherheitseinstellungen.

In diesem Artikel zeige ich dir, wie du Immich auf einem Ubuntu 24.04 Server installierst und konfigurierst. Wir werden zwei Installationsmethoden betrachten: über Docker Compose (die empfohlene Methode) und über Snap-Pakete. Du wirst sehen, dass die Einrichtung mit etwas technischem Grundwissen gut zu bewältigen ist.

⚠️ Hinweis: Immich befindet sich noch in aktiver Entwicklung. Einige Funktionen könnten sich in zukünftigen Versionen ändern. Dieser Artikel basiert auf dem Stand von Mai 2025.

Voraussetzungen

Bevor wir mit der Installation von Immich beginnen, sollten wir sicherstellen, dass dein System alle notwendigen Voraussetzungen erfüllt. Eine gute Vorbereitung erspart dir später viel Ärger und Fehlerbehebung.

Hardwareanforderungen

Immich ist ressourcenhungrig, besonders wenn du eine größere Fotosammlung verwalten möchtest. Hier sind die Mindestanforderungen:

• CPU: Mindestens 2 Kerne, empfohlen 4+ Kerne
• RAM: Mindestens 4 GB, empfohlen 8 GB oder mehr
• Speicherplatz: Abhängig von deiner Fotosammlung, aber mindestens 20 GB für das System plus den Speicherplatz für deine Medien
• Netzwerk: Stabile Internetverbindung, idealerweise mit fester IP-Adresse oder DynDNS

⚠️ Wichtig: Die Gesichtserkennung und KI-Funktionen von Immich benötigen deutlich mehr Ressourcen. Wenn du diese Funktionen nutzen möchtest, plane mindestens 8 GB RAM ein.

┌─────────────────────────────────────────────────┐
│ Ressourcenverbrauch nach Funktionen             │
├─────────────────────┬───────────────────────────┤
│ Grundfunktionen     │ 2 CPU Kerne, 4 GB RAM     │
│ + Gesichtserkennung │ 4 CPU Kerne, 8 GB RAM     │
│ + Große Bibliothek  │ 4+ CPU Kerne, 16+ GB RAM  │
└─────────────────────┴───────────────────────────┘

Softwareanforderungen

• Betriebssystem: Ubuntu 24.04 LTS Server (frisch installiert und aktualisiert)
• Benutzerrechte: Sudo-Berechtigungen für die Installation
• Zusätzliche Software: Je nach Installationsmethode benötigst du:
  • Für Docker: Docker Engine und Docker Compose
  • Für Snap: Snapd-Unterstützung (standardmäßig in Ubuntu 24.04 vorhanden)

Netzwerkkonfiguration

Für den Zugriff auf deinen Immich-Server benötigst du:

• Lokaler Zugriff: Port 2283 (Standard) muss im internen Netzwerk erreichbar sein
• Externer Zugriff: Wenn du von außerhalb auf deinen Server zugreifen möchtest, benötigst du:
  • Eine feste IP-Adresse oder DynDNS-Konfiguration
  • Port-Weiterleitung in deinem Router (Port 2283 oder einen anderen von dir gewählten Port)
  • Idealerweise einen Reverse-Proxy mit SSL-Verschlüsselung (z.B. Nginx oder Traefik)

💡 Tipp: Aus Sicherheitsgründen empfehle ich, Immich nicht direkt über das Internet zugänglich zu machen, sondern einen VPN-Zugang zu deinem Heimnetzwerk einzurichten oder einen Reverse-Proxy mit SSL-Verschlüsselung zu verwenden.

Systemvorbereitung

Bevor wir mit der eigentlichen Installation beginnen, sollten wir das System aktualisieren:

sudo apt update
sudo apt upgrade -y

Warum machen wir das? Ein aktuelles System bietet die beste Kompatibilität und schließt bekannte Sicherheitslücken. Außerdem installieren wir gleich einige grundlegende Tools, die wir später benötigen werden:

sudo apt install -y curl wget git

Diese Tools brauchen wir später, um Konfigurationsdateien herunterzuladen und zu bearbeiten.

⚠️ Hinweis: Stelle sicher, dass dein System über ausreichend freien Speicherplatz verfügt. Du kannst dies mit dem Befehl df -h überprüfen.

Nachdem wir nun alle Voraussetzungen geklärt haben, können wir im nächsten Abschnitt die verschiedenen Installationsmethoden genauer betrachten.

Installationsmethoden

Bevor wir in die Details der Installation eintauchen, sollten wir die verschiedenen Möglichkeiten betrachten, wie du Immich auf deinem Ubuntu 24.04 Server installieren kannst. Es gibt hauptsächlich zwei Wege, die für die meisten Anwender relevant sind:

Docker Compose (empfohlene Methode)

Die Installation über Docker Compose ist der vom Immich-Entwicklerteam empfohlene Weg. Docker ist eine Containerisierungstechnologie, die es ermöglicht, Anwendungen und ihre Abhängigkeiten in isolierten Umgebungen auszuführen.

Vorteile:

• Einfache Installation und Updates
• Klare Trennung der Komponenten
• Offiziell unterstützt und dokumentiert
• Konsistente Umgebung unabhängig vom Hostsystem
• Einfaches Backup durch Volume-Mounts

Nachteile:

• Leicht höherer Ressourcenverbrauch
• Zusätzliche Abstraktionsebene, die bei Problemen das Debugging erschweren kann

Snap-Paket

Snap ist ein Paketformat von Canonical (dem Unternehmen hinter Ubuntu), das Software in einem Container bereitstellt.

Vorteile:

• Sehr einfache Installation mit einem Befehl
• Automatische Updates
• Integriert sich gut in Ubuntu

Nachteile:

• Weniger Konfigurationsmöglichkeiten
• Nicht vom Immich-Team offiziell unterstützt
• Möglicherweise nicht immer auf dem neuesten Stand

Entscheidungshilfe

Welche Methode solltest du wählen? Hier eine kleine Entscheidungshilfe:

• Wähle Docker Compose, wenn:
  • Du maximale Kontrolle über die Installation haben möchtest
  • Du regelmäßig die neuesten Features nutzen willst
  • Du bereits Erfahrung mit Docker hast
  • Du spezifische Anpassungen vornehmen möchtest
• Wähle Snap, wenn:
  • Du eine möglichst einfache Installation bevorzugst
  • Du wenig Zeit für Wartung aufwenden möchtest
  • Du keine speziellen Anpassungen benötigst
  • Du mit Ubuntu-Tools vertraut bist

💡 Tipp: Für die meisten Nutzer empfehle ich die Docker-Compose-Methode, da sie vom Entwicklerteam besser unterstützt wird und dir mehr Flexibilität bietet. In diesem Artikel werden wir beide Methoden behandeln, beginnend mit der einfacheren Snap-Installation.

⚠️ Hinweis: Unabhängig von der gewählten Installationsmethode solltest du regelmäßige Backups deiner Daten durchführen. Wir werden später im Artikel darauf eingehen, wie du das am besten anstellst.

Jetzt, da wir die Optionen kennen, können wir mit der ersten Installationsmethode beginnen.

Installation via Snap-Paket

Beginnen wir mit der einfacheren der beiden Installationsmethoden: der Installation über Snap. Diese Methode ist besonders für Einsteiger geeignet, die schnell und unkompliziert starten möchten.

System vorbereiten

Obwohl Ubuntu 24.04 bereits mit Snap vorinstalliert ist, sollten wir sicherstellen, dass es auf dem neuesten Stand ist:

sudo snap refresh

💡 Warum machen wir das? Ein aktuelles Snap-System stellt sicher, dass wir die neueste Version von Immich erhalten und von allen Verbesserungen profitieren.

Snap installieren und konfigurieren

Falls Snap auf deinem System nicht installiert sein sollte (was bei einer Standardinstallation von Ubuntu 24.04 ungewöhnlich wäre), kannst du es mit folgendem Befehl nachinstallieren:

sudo apt update
sudo apt install snapd -y

Nachdem Snap installiert ist, solltest du deinen Server neu starten, um sicherzustellen, dass alle Snap-Dienste korrekt initialisiert werden:

sudo reboot

Nach dem Neustart können wir fortfahren.

Immich installieren

Jetzt kommt der einfache Teil. Um Immich zu installieren, führe einfach folgenden Befehl aus:

sudo snap install immich

Das System wird nun automatisch das Immich-Snap-Paket herunterladen und installieren. Dies kann je nach deiner Internetverbindung einige Minuten dauern.

⚠️ Hinweis: Während der Installation werden keine Fragen gestellt. Das Snap-Paket verwendet Standardeinstellungen, die für die meisten Anwendungsfälle geeignet sind.

Nach Abschluss der Installation sollte Immich automatisch gestartet werden. Du kannst den Status überprüfen mit:

sudo snap services immich

Die Ausgabe sollte in etwa so aussehen:

Service          Startup  Current  Notes
immich.server    enabled  active   -
immich.database  enabled  active   -

Wenn alle Dienste als „active“ angezeigt werden, läuft Immich bereits!

Konfiguration anpassen

Die Snap-Installation von Immich verwendet standardmäßig den Port 2283 für die Weboberfläche. Falls du diesen Port ändern möchtest, kannst du das mit folgendem Befehl tun:

sudo snap set immich port=8080

Ersetze „8080“ durch den Port deiner Wahl. Denke daran, dass du nach dieser Änderung den Dienst neu starten musst:

sudo snap restart immich

Standardmäßig speichert Immich alle Daten im Verzeichnis /var/snap/immich/common/.

Hier werden sowohl die Datenbank als auch deine hochgeladenen Medien gespeichert. Wenn du einen anderen Speicherort verwenden möchtest (z.B. eine externe Festplatte), musst du einen symbolischen Link erstellen:

# Stoppe Immich
sudo snap stop immich

# Sichere die vorhandenen Daten
sudo cp -r /var/snap/immich/common/uploads /pfad/zum/neuen/speicherort/

# Entferne das alte Verzeichnis
sudo rm -rf /var/snap/immich/common/uploads

# Erstelle einen symbolischen Link
sudo ln -s /pfad/zum/neuen/speicherort/uploads /var/snap/immich/common/uploads

# Starte Immich wieder
sudo snap start immich

💡 Tipp: Stelle sicher, dass der neue Speicherort die richtigen Berechtigungen hat. Der Snap-Dienst muss darauf zugreifen können.

Firewall-Konfiguration

Damit du auf die Immich-Weboberfläche zugreifen kannst, musst du den entsprechenden Port in der Firewall öffnen. Wenn du UFW (Uncomplicated Firewall) verwendest, was bei Ubuntu Standard ist, kannst du das mit folgendem Befehl tun:

sudo ufw allow 2283/tcp
sudo ufw reload

💡Warum machen wir das? Ohne diese Freigabe könntest du nicht auf die Weboberfläche von Immich zugreifen, da die Firewall den Datenverkehr blockieren würde.

http://deine-server-ip:2283

Nachdem die Installation abgeschlossen ist, kannst du auf die Immich-Weboberfläche zugreifen, indem du in deinem Browser folgende Adresse aufrufst:

💡Ersetze "deine-server-ip" durch die IP-Adresse deines Ubuntu-Servers. Wenn du den Server lokal verwendest, kannst du auch localhost verwenden.

⚠️ Wichtig: Bei der ersten Verbindung wirst du aufgefordert, ein Administrator-Konto einzurichten (siehe: Zugriff auf die Weboberfläche). Wähle ein sicheres Passwort, da dieses Konto vollen Zugriff auf alle deine gespeicherten Fotos und Videos hat.

Das war’s! Du hast Immich erfolgreich über Snap installiert. Im nächsten Abschnitt werden wir die Installation über Docker Compose behandeln, die mehr Konfigurationsmöglichkeiten bietet.

Installation via Docker Compose

Die Installation von Immich über Docker Compose ist die vom Entwicklerteam empfohlene Methode. Sie bietet mehr Flexibilität und Kontrolle über die einzelnen Komponenten. In diesem Abschnitt führe ich dich Schritt für Schritt durch den Prozess.

Docker und Docker Compose installieren

Zunächst müssen wir Docker und Docker Compose auf deinem Ubuntu 24.04 Server installieren. Docker ist die Containerplattform, während Docker Compose ein Tool ist, das die Verwaltung mehrerer Docker-Container erleichtert.

Beginnen wir mit der Installation der erforderlichen Pakete:

sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

💡Warum diese Pakete? Sie ermöglichen sichere Verbindungen und das Hinzufügen von externen Paketquellen, was wir für Docker benötigen.

Als Nächstes fügen wir den offiziellen Docker-GPG-Schlüssel hinzu:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Dieser Schlüssel stellt sicher, dass die Pakete, die wir herunterladen, tatsächlich von Docker stammen und nicht manipuliert wurden.

Jetzt fügen wir das Docker-Repository zu den APT-Quellen hinzu:

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Aktualisiere die Paketlisten und installiere Docker:

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Überprüfe, ob Docker korrekt installiert wurde:

sudo docker run hello-world

Wenn alles funktioniert, solltest du eine Erfolgsmeldung sehen.

💡 Tipp: Um Docker ohne sudo-Rechte verwenden zu können, füge deinen Benutzer zur Docker-Gruppe hinzu:

sudo usermod -aG docker $USER

Damit diese Änderung wirksam wird, melde dich ab und wieder an oder starte den Server neu.

Erforderliche Dateien herunterladen

Immich stellt eine vorkonfigurierte Docker-Compose-Datei bereit, die wir für unsere Installation verwenden können. Erstelle zunächst ein Verzeichnis für Immich:

mkdir -p ~/immich
cd ~/immich

Lade die erforderlichen Dateien herunter:

wget https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget https://github.com/immich-app/immich/releases/latest/download/example.env -O .env

⚠️ Hinweis: Überprüfe regelmäßig die offizielle GitHub-Seite auf Updates, da sich die URLs ändern können.

Umgebungsvariablen konfigurieren

Die Datei .env enthält alle Konfigurationsoptionen für Immich. Öffne sie mit einem Texteditor:

nano .env

Hier sind einige wichtige Einstellungen, die du anpassen solltest:

1. UPLOAD_LOCATION: Der Pfad, wo deine Fotos und Videos gespeichert werden. Standardmäßig ist dies ./library.
2. DB_PASSWORD: Setze ein sicheres Passwort für die Datenbank.
3. JWT_SECRET: Ändere diesen Wert zu einem zufälligen String für mehr Sicherheit.

Beispiel für eine angepasste .env-Datei:

# Immich-Konfiguration
UPLOAD_LOCATION=/mnt/data/immich/library
DB_PASSWORD=MeinSuperSicheresPasswort123!
JWT_SECRET=EinZufaelligerStringFuerMehrSicherheit

# Weitere Einstellungen bleiben unverändert

💡 Warum diese Änderungen? Der UPLOAD_LOCATION sollte idealerweise auf einem Speichermedium mit ausreichend Platz liegen. Die Sicherheitseinstellungen schützen deine Daten vor unbefugtem Zugriff.

Docker-Compose-Umgebung                       

┌─────────────┐  ┌─────────────┐  ┌─────────────┐  
│             │  │             │  │             │  
│  Immich     │  │  Postgres   │  │  Redis      │  
│  Server     │  │  Datenbank  │  │  Cache      │  
│             │  │             │  │             │    
└─────────────┘  └─────────────┘  └─────────────┘      
      │               │                │              
      └───────────────┼────────────────┘              
                      │                               
               ┌──────▼──────┐                       
               │             │           
               │  Volumes    │                       
               │  (Daten)    │                        
               │             │                        
               └─────────────┘                        

Immich starten

Nachdem wir die Konfiguration angepasst haben, können wir Immich starten:

docker compose up -d

💡 Der Parameter -d startet die Container im Hintergrund (detached mode). 

Docker Compose wird nun alle erforderlichen Container herunterladen und starten. Dies kann einige Minuten dauern, abhängig von deiner Internetverbindung.

Du kannst den Fortschritt mit folgendem Befehl überwachen:

docker compose logs -f

Drücke Ctrl+C, um die Log-Anzeige zu beenden.

Um zu überprüfen, ob alle Container laufen:

docker compose ps

Alle Container sollten den Status „Up“ haben.

Firewall-Konfiguration

Wie bei der Snap-Installation müssen wir den Port für die Weboberfläche in der Firewall freigeben:

sudo ufw allow 2283/tcp
sudo ufw reload

Automatischer Start nach Neustart

Damit Immich nach einem Serverneustart automatisch startet, können wir einen systemd-Service erstellen:

sudo nano /etc/systemd/system/immich.service

Füge folgenden Inhalt ein:

[Unit]
Description=Immich Docker Compose
Requires=docker.service
After=docker.service

[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/home/DEIN_BENUTZERNAME/immich
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down

[Install]
WantedBy=multi-user.target

💡 Ersetze DEIN_BENUTZERNAME durch deinen tatsächlichen Benutzernamen.

Aktiviere und starte den Service:

sudo systemctl enable immich.service
sudo systemctl start immich.service

⚠️ Wichtig: Wenn du den Pfad zu deinem Immich-Verzeichnis änderst, musst du auch die systemd-Service-Datei aktualisieren.

Bei der ersten Verbindung wirst du aufgefordert, ein Administrator-Konto einzurichten.

💡 Tipp: Für eine sicherere Verbindung solltest du einen Reverse-Proxy mit SSL-Verschlüsselung einrichten. Tools wie Nginx Proxy Manager oder Traefik können dir dabei helfen.

Die Docker-Compose-Installation bietet dir mehr Kontrolle und Flexibilität als die Snap-Variante. Im nächsten Abschnitt werden wir uns mit der Erstkonfiguration und dem Zugriff auf Immich beschäftigen.

Erstkonfiguration und Zugriff

Nachdem du Immich erfolgreich installiert hast – sei es über Snap oder Docker Compose – ist es Zeit, die Anwendung zu konfigurieren und einzurichten. In diesem Abschnitt führe ich dich durch die ersten Schritte nach der Installation.

Weboberfläche aufrufen

Öffne deinen Webbrowser und navigiere zur Immich-Weboberfläche:

http://deine-server-ip:2283

💡Ersetze "deine-server-ip" durch die IP-Adresse deines Ubuntu-Servers.

Beim ersten Aufruf wirst du mit einer Einrichtungsseite begrüßt, die so aussieht:

Administrator-Konto einrichten

Die Einrichtung eines Administrator-Kontos ist der erste und wichtigste Schritt. Dieses Konto hat volle Kontrolle über deine Immich-Installation.

1. E-Mail-Adresse: Gib eine gültige E-Mail-Adresse ein. Diese wird für die Anmeldung verwendet.
2. Passwort: Wähle ein sicheres Passwort mit mindestens 8 Zeichen, das Groß- und Kleinbuchstaben, Zahlen und Sonderzeichen enthält.
3. Name: Dein Name oder Benutzername, der in der Anwendung angezeigt wird.

⚠️ Sicherheitshinweis: Verwende ein einzigartiges, starkes Passwort für dein Immich-Administratorkonto. Da es sich um eine selbstgehostete Anwendung handelt, die möglicherweise über das Internet zugänglich ist, ist ein starkes Passwort besonders wichtig.

Nachdem du das Formular ausgefüllt hast, klicke auf „Konto erstellen“. Du wirst zur Login-Seite weitergeleitet, wo du dich mit deinen gerade erstellten Zugangsdaten (E-Mail und Passwort) anmelden musst. Nach erfolgreicher Anmeldung startet die Schnelleinrichtung.

Schnelleinrichtung durchführen

Nach dem ersten Login führt dich Immich durch einen Schnelleinrichtungsprozess mit mehreren Schritten:

Farbthema auswählen

Hier kannst du zwischen einem hellen und dunklen Design wählen.

Privatsphäre-Einstellungen

In diesem Schritt kannst du entscheiden, welche externen Dienste du nutzen möchtest:

• Karte: Verwendet einen externen Tile-Service (tiles.immich.cloud)
• Versionsprüfung: Kommuniziert regelmäßig mit GitHub.com

Speichervorlage konfigurieren

Bei diesem Schritt geht es um die Organisation deiner Dateien.

Du siehst eine Erklärung:

💡Wenn aktiviert, sortiert diese Funktion Dateien automatisch basierend auf einer benutzerdefinierten Vorlage. Aufgrund von Stabilitätsproblemen ist die Funktion standardmäßig deaktiviert. Weitere Informationen findest du in der Dokumentation.

Wenn du auf „Speichervorlagen-Engine aktivieren“ klickst, öffnet sich ein detaillierter Konfigurationsbildschirm mit zahlreichen Variablen:

DATUM UND ZEIT
Der Erstellungszeitstempel der Datei wird für die Datums- und Uhrzeitinformation verwendet.
Beispielzeitpunkt: 2022-02-03T04:56:05.250

• JAHR
  • {{y}} – 2022
  • {{yy}} – 22
• MONAT
  • {{M}} – 2
  • {{MM}} – 02
  • {{MMM}} – Feb
  • {{MMMM}} – Februar
• TAG
  • {{d}} – 3
  • {{dd}} – 03
  • {{ddd}} – Do
  • {{dddd}} – Donnerstag
• STUNDE
  • {{h}} – 4
  • {{hh}} – 04
  • {{hhh}} – 04
• MINUTE
  • {{m}} – 56
  • {{mm}} – 56
  • {{mmm}} – 056
• SEKUNDE
  • {{s}} – 5
  • {{ss}} – 05
  • {{sss}} – 05
  • {{SSSS}} – 250

SONSTIGE VARIABLEN

• DATEINAME
  • {{filename}} – IMG_123
• DATEITYP
  • {{filetype}} – IMG, VIDEO oder IMAGE
• SONSTIGES
  • {{assetId}} – Asset ID
  • {{assetIdShort}} – Asset ID (letzten 12 Zeichen)
  • {{album}} – Album Name
  • {{album-startDate}} – Album Start Date and Time (z.B. album-startDate-yy)
  • {{album-endDate}} – Album End Date and Time (z.B. album-endDate-MM)

Im Bereich „Vorlage“ kannst du dann dein eigenes Muster erstellen. Es gibt eine Vorschau, die dir zeigt, wie deine Dateien organisiert werden würden, und ein Pfadlängen-Limit (standardmäßig 78/260 Zeichen).

💡Ein Beispiel für eine Vorlage wäre: {{y}}/{{y}}-{{MM}}-{{dd}}/{{filename}}, was zu einer Struktur wie "2022/2022-02-03/IMG_56437.jpg" führen würde.

⚠️ Hinweis: Achte darauf, dass deine Vorlage nicht zu langen Pfaden führt, da dies zu Problemen führen kann. Die Vorschau zeigt dir, wie die Struktur aussehen würde.

Zugriff auf Verwaltungseinstellungen

In Immich Version v1.132.3 und neuer findest du die Verwaltungseinstellungen über das Benutzerbild in der oberen rechten Ecke. Dort kannst du auf „Kontoeinstellungen“ und „Verwaltung“ zugreifen, um alle Systemeinstellungen anzupassen.

💡 Tipp: Für eine vollständige Übersicht aller Einstellungsmöglichkeiten empfehle ich die offizielle Dokumentation unter https://immich.app/docs/, die regelmäßig aktualisiert wird und alle Funktionen im Detail erklärt. Die Benutzeroberfläche von Immich wird kontinuierlich weiterentwickelt, daher können sich Menüpunkte und Optionen in neueren Versionen ändern.

Mobile App einrichten

Ein großer Vorteil von Immich ist die Möglichkeit, deine Fotos automatisch von deinem Smartphone zu synchronisieren. Dafür gibt es offizielle Apps für Android und iOS.

1. Installiere die Immich-App aus dem Google Play Store oder Apple App Store
2. Öffne die App und tippe auf „Server-URL hinzufügen“
3. Gib die URL deines Immich-Servers ein (z.B. http://deine-server-ip:2283)
4. Melde dich mit deinen Zugangsdaten an

⚠️ Wichtig: Wenn du von außerhalb deines Heimnetzwerks auf Immich zugreifen möchtest, musst du entweder eine Port-Weiterleitung in deinem Router einrichten oder, besser noch, einen Reverse-Proxy mit SSL-Verschlüsselung verwenden.

Erste Schritte mit Immich

Nach der Grundkonfiguration kannst du mit der Nutzung von Immich beginnen:

1. Fotos hochladen: Klicke auf die Schaltfläche „Hochladen“ in der oberen rechten Ecke, um Fotos manuell hochzuladen.
2. Alben erstellen: Erstelle Alben, um deine Fotos zu organisieren.
3. Teilen: Teile Alben mit anderen Benutzern deiner Immich-Instanz.
4. Suchen: Nutze die Suchfunktion, um Fotos nach Datum, Ort oder Gesichtern zu finden (falls aktiviert).

💡 Tipp: Nimm dir Zeit, um die Benutzeroberfläche zu erkunden. Immich bietet viele Funktionen, die du von kommerziellen Fotodiensten kennst, wie Zeitachsen, Standortansichten und Gesichtserkennung.

Jetzt, da deine Immich-Installation eingerichtet und konfiguriert ist, wirst du vielleicht auf einige Probleme stoßen. Im nächsten Abschnitt behandeln wir häufige Fehlerquellen und wie du sie beheben kannst.

Troubleshooting

Bei der Arbeit mit Immich können verschiedene Probleme auftreten. In diesem Abschnitt zeige ich dir, wie du häufige Fehlerquellen identifizieren und beheben kannst.

Typische Fehlerquellen

Weboberfläche nicht erreichbar

Wenn du nach der Installation nicht auf die Weboberfläche unter http://deine-server-ip:2283 zugreifen kannst, überprüfe folgende Punkte:

Firewall-Einstellungen: Stelle sicher, dass Port 2283 in deiner Firewall freigegeben ist:

sudo ufw status
# Falls der Port nicht freigegeben ist
sudo ufw allow 2283/tcp
sudo ufw reload

Docker-Container-Status: Bei der Docker-Installation solltest du prüfen, ob alle Container laufen:

docker compose ps

⚠️ Hinweis: Alle Container sollten den Status "Up" haben.

Snap-Dienst-Status: Bei der Snap-Installation überprüfe den Status der Dienste:

sudo snap services immich

Fehler beim Laden von Bildern

„Error Loading Image“ ist ein häufiges Problem bei Immich und kann verschiedene Ursachen haben:

• Falsche Dateipfade: Überprüfe, ob die konfigurierten Pfade in der docker-compose.yml oder .env-Datei korrekt sind.
• Probleme bei der Thumbnail-Generierung: Fehlende oder unvollständige Thumbnail-Dateien können dazu führen, dass Bilder als beschädigt angezeigt werden.
• Versionskonflikte: Bestimmte Immich-Versionen können Probleme mit dem Zugriff auf Thumbnails oder Dateien verursachen.

💡 Tipp: Wenn du Probleme mit dem Laden von Bildern hast, versuche die Thumbnails neu zu generieren. Bei der Docker-Installation kannst du dies über die Administrationsoberfläche unter "Jobs" tun.

Datenbank-Probleme

Wenn Immich Probleme mit der Datenbank meldet, könnte dies an folgenden Faktoren liegen:

• Unzureichende Berechtigungen: Die Datenbank-Benutzer haben möglicherweise nicht die erforderlichen Rechte.
• Speicherplatz erschöpft: Überprüfe den verfügbaren Speicherplatz auf deinem Server.
• Beschädigte Datenbank: Nach einem unerwarteten Neustart könnte die Datenbank beschädigt sein.

Logfiles und Diagnose

Die Logdateien sind dein bester Freund bei der Fehlersuche. Hier erfährst du, wie du auf sie zugreifen kannst:

Docker-Installation

Bei der Docker-Installation kannst du die Logs aller Container anzeigen mit:

docker compose logs

Um nur die Logs eines bestimmten Containers zu sehen, z.B. des Immich-Servers:

docker compose logs immich-server

Für eine Echtzeitansicht der Logs (besonders nützlich bei der Fehlersuche):

docker compose logs -f

Snap-Installation

Bei der Snap-Installation kannst du die Logs mit dem journalctl-Befehl anzeigen:

sudo journalctl -u snap.immich.*

Um nur die neuesten Logs zu sehen:

sudo journalctl -u snap.immich.* -n 100

Lösungsansätze

Container neu starten

Bei der Docker-Installation kannst du versuchen, die Container neu zu starten:

docker compose down
docker compose up -d

Thumbnails neu generieren

Wenn Bilder nicht korrekt angezeigt werden, kann es helfen, die Thumbnails neu zu generieren:

1. Melde dich in der Weboberfläche an
2. Navigiere zur Verwaltung (über das Benutzerbild oben rechts)
3. Wähle „Jobs“ und starte den Job „Thumbnails generieren“

Auf eine stabile Version zurücksetzen

Wenn du nach einem Update Probleme hast, kann es hilfreich sein, auf eine bekannte stabile Version zurückzusetzen:

Bei der Docker-Installation:

1. Bearbeite die .env-Datei und setze IMMICH_VERSION auf die gewünschte Version
2. Führe docker compose down und dann docker compose up -d aus

Bei der Snap-Installation:

sudo snap revert immich

⚠️ Wichtig: Mache immer ein Backup deiner Daten, bevor du größere Änderungen vornimmst oder auf eine andere Version wechselst.

Fehlerbehebungs-Workflow:                          
                                                     
1. Problem identifizieren ──────┐                  
                                │                  
2. Logs überprüfen ◄────────────┘                
         │                                           
         ▼                                           
3. Lösungsansatz anwenden                          
         │                                           
         ▼                                           
4. Ergebnis überprüfen ────► Erfolgreich? ───────┐   
         │                         │             │   
         │ Nein                    │ Ja          │   
         ▼                         ▼             │   
5. Anderen Ansatz versuchen   Problem gelöst     │   
         │                                       │   
         └───────────────────────────────────────┘   

💡 Mit diesen Tipps solltest du die meisten Probleme bei der Nutzung von Immich lösen können. Falls du auf komplexere Probleme stößt, empfehle ich dir, die offizielle Dokumentation unter https://immich.app/docs/ zu konsultieren oder im GitHub-Repository nach ähnlichen Problemen zu suchen.

Sicherheit und Backup

Nachdem wir nun Immich installiert und konfiguriert haben, ist es wichtig, sich mit der Absicherung deiner Installation und einer soliden Backup-Strategie zu beschäftigen. In diesem Abschnitt zeige ich dir, wie du deine Immich-Installation schützen und deine wertvollen Erinnerungen sichern kannst.

Absicherung der Installation

Netzwerksicherheit

Immich bietet standardmäßig keine verschlüsselte Verbindung an. Wenn du von außerhalb deines Heimnetzwerks auf Immich zugreifen möchtest, solltest du unbedingt eine sichere Verbindung einrichten.

Hier sind zwei empfohlene Ansätze:

VPN-Zugang

Die einfachste und sicherste Methode ist die Einrichtung eines VPN-Zugangs zu deinem Heimnetzwerk. Beliebte Lösungen sind OpenVPN und Wireguard.

Vorteile:

• Sehr sicher und einfach einzurichten
• Schützt vor potenziellen Sicherheitslücken in Immich
• Sowohl Wireguard als auch OpenVPN wurden unabhängig auf Sicherheit geprüft

Reverse-Proxy mit HTTPS

Alternativ kannst du einen Reverse-Proxy mit HTTPS-Verschlüsselung einrichten:

# Bei der Snap-Installation
sudo snap set immich-distribution https-enabled=true
sudo snap set immich-distribution acme-domain=deine-domain.de
sudo snap set immich-distribution acme-email=deine-email@beispiel.de

Bei der Docker-Installation kannst du Nginx, Traefik oder HAProxy als Reverse-Proxy verwenden.

⚠️ Wichtig: Stelle Immich niemals unverschlüsselt über das Internet zur Verfügung! Dies würde deine Daten und Zugangsdaten gefährden.

Benutzerberechtigungen

Beschränke die Anzahl der Administratorkonten auf das Notwendige. Erstelle für normale Benutzer Konten mit eingeschränkten Rechten:

1. Navigiere zur Verwaltung über das Benutzerbild oben rechts
2. Erstelle neue Benutzer mit der Rolle „Standard“
3. Teile nur die Alben und Medien, die tatsächlich geteilt werden sollen

Regelmäßige Updates

Halte deine Immich-Installation stets aktuell, um von Sicherheitsverbesserungen zu profitieren:

• Snap-Installation: Updates werden automatisch installiert
• Docker-Installation: Führe regelmäßig folgende Befehle aus:

cd ~/immich
docker compose pull
docker compose down
docker compose up -d

Backup-Strategien

Eine gute Backup-Strategie ist entscheidend, um den Verlust deiner Fotos und Videos zu verhindern. Hier sind verschiedene Ansätze:

Datenbank-Backup

Bei der Snap-Installation:

# Datenbank-Backup erstellen
sudo immich-distribution.backup -d

Die Backup-Dateien werden unter /var/snap/immich-distribution/common/backups gespeichert.

Bei der Docker-Installation:

# Datenbank-Backup erstellen
cd ~/immich
docker compose exec postgres pg_dump -U postgres -d immich > immich_db_backup_$(date +%Y%m%d).sql

Medien-Backup

Deine Fotos und Videos sind das Wertvollste in deiner Immich-Installation. Sichere sie regelmäßig:

Bei der Snap-Installation:

# Medien-Backup erstellen (kann sehr langsam sein)
sudo immich-distribution.backup -a

# Alternativ direktes Kopieren der Dateien
sudo cp -r /var/snap/immich-distribution/common/upload /pfad/zum/backup/

Bei der Docker-Installation:

# Medien-Backup erstellen
rsync -av ~/immich/library /pfad/zum/backup/

💡 Tipp: Verwende Tools wie rsync für inkrementelle Backups, um Speicherplatz zu sparen und die Backup-Zeit zu verkürzen.

3-2-1 Backup-Strategie

Für maximale Sicherheit empfehle ich die 3-2-1 Backup-Strategie:

• 3 Kopien deiner Daten
• Auf 2 verschiedenen Medientypen
• 1 Kopie an einem anderen Ort

Ein praktisches Setup könnte so aussehen:

1. Deine Immich-Installation auf dem Server (primäre Kopie)
2. Wöchentliches Backup auf eine externe Festplatte (zweite Kopie)
3. Monatliches Backup auf eine weitere externe Festplatte, die außer Haus aufbewahrt wird, oder in einen verschlüsselten Cloud-Speicher (dritte Kopie)

⚠️ Wichtig: Teste deine Backups regelmäßig durch Wiederherstellung in einer Testumgebung. Ein Backup, das nicht wiederhergestellt werden kann, ist wertlos.

Updates verwalten

Snap-Installation

Bei der Snap-Installation werden Updates automatisch installiert. Du kannst den Status überprüfen mit:

sudo snap info immich-distribution

Falls ein Update Probleme verursacht, kannst du zur vorherigen Version zurückkehren:

sudo snap revert immich-distribution

Docker-Installation

Bei der Docker-Installation musst du Updates manuell durchführen:

cd ~/immich
docker compose pull
docker compose down
docker compose up -d

Wenn du auf eine bestimmte Version aktualisieren möchtest, kannst du die Version in der .env-Datei festlegen:

IMMICH_VERSION=v1.132.3

💡 Tipp: Erstelle immer ein Backup, bevor du ein Update durchführst. So kannst du im Problemfall schnell zur vorherigen Version zurückkehren.

Mit diesen Sicherheits- und Backup-Strategien ist deine Immich-Installation gut geschützt, und du kannst sicher sein, dass deine wertvollen Erinnerungen nicht verloren gehen.

Wichtige Ressourcen

Hier findest du weiterführende Informationen und Hilfestellungen für deine Immich-Installation:

Offizielle Dokumentation

• Immich Dokumentation: https://immich.app/docs/ – Umfassende und stets aktuelle Anleitungen zu allen Aspekten von Immich

Community und Support

• GitHub Repository: https://github.com/immich-app/immich – Quellcode, Issues und Diskussionen
• Discord-Server: https://discord.gg/D8JsnBEuKb – Direkter Austausch mit Entwicklern und anderen Nutzern
• Reddit-Community: https://www.reddit.com/r/immich/ – Diskussionen, Tipps und Erfahrungsberichte

Tutorials und Anleitungen

• Immich Wiki: https://github.com/immich-app/immich/wiki – Zusätzliche Informationen und Community-Beiträge
• Docker-Dokumentation: https://docs.docker.com/ – Hilfe bei Docker-spezifischen Fragen
• Ubuntu Server-Dokumentation: https://ubuntu.com/server/docs – Hilfe bei Ubuntu-spezifischen Fragen

Verwandte Projekte

• Nginx Proxy Manager: https://nginxproxymanager.com/ – Einfache Einrichtung eines Reverse-Proxy mit SSL
• Duplicati: https://www.duplicati.com/ – Tool für automatisierte Backups
• Watchtower: https://containrrr.dev/watchtower/ – Automatische Updates für Docker-Container

Sicherheit und Datenschutz

• Let’s Encrypt: https://letsencrypt.org/ – Kostenlose SSL-Zertifikate
• Wireguard: https://www.wireguard.com/ – Moderne VPN-Lösung für sicheren Zugriff

💡 Diese Ressourcen helfen dir, deine Immich-Installation zu optimieren, Probleme zu lösen und auf dem neuesten Stand zu bleiben. Die aktive Community bietet zudem wertvolle Unterstützung bei spezifischen Fragen oder Herausforderungen.

Fazit

Mit diesem Artikel hast du nun alle notwendigen Werkzeuge und Kenntnisse, um Immich auf einem Ubuntu 24.04 Server zu installieren und zu konfigurieren. Du kannst zwischen der einfachen Snap-Installation und der flexibleren Docker-Compose-Methode wählen, je nach deinen Bedürfnissen und Vorkenntnissen.

Immich entwickelt sich kontinuierlich weiter, und neue Funktionen werden regelmäßig hinzugefügt. Halte deine Installation daher stets aktuell, um von Verbesserungen und Sicherheitsupdates zu profitieren. Mit einer soliden Backup-Strategie und den richtigen Sicherheitsmaßnahmen kannst du deine Fotos und Videos sicher und privat verwalten, ohne auf die Bequemlichkeit kommerzieller Dienste verzichten zu müssen.

Experimentiere mit den verschiedenen Funktionen von Immich, passe die Einstellungen an deine Bedürfnisse an und entdecke, wie befreiend es sein kann, die volle Kontrolle über deine digitalen Erinnerungen zu haben.

⚠️ Hinweis: Denke daran, dass selbstgehostete Dienste regelmäßige Wartung erfordern. Plane Zeit für Updates, Backups und gelegentliche Fehlerbehebung ein, um eine reibungslose Nutzung zu gewährleisten.

Viel Erfolg mit deiner eigenen Immich-Installation!