--- id: 2025-05-12-immich-private-foto-cloud-unter-ubuntu-24-04-lts-server-installieren slug: immich-private-foto-cloud-unter-ubuntu-24-04-lts-server-installieren title: "Immich: Private Foto-Cloud Unter Ubuntu 24.04 LTS Server Installieren" excerpt: "Erfahre, wie du Immich auf Ubuntu 24.04 LTS installierst und konfigurierst. Diese Anleitung führt dich durch alle Schritte von der Installation bis zum Backup." date: "2025-05-12T09:00:00+02:00" updated: "2025-05-12T09:00:00+02:00" author: name: "Sebastian Palencsár" handle: "spalencsar" category: ["serverumgebungen"] tags: ["immich", "ubuntu", "docker", "linux", "linuxtutorial", "opensource"] reading_time: 27 toc: true --- [Immich](https://immich.app/){.badge-link-text} 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](https://photos.google.com/){.badge-link-text} 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](https://ubuntu.com/download/server){.badge-link-text} installierst und konfigurierst. **Wir werden zwei Installationsmethoden betrachten:** Über [Docker Compose](https://docs.docker.com/compose/){.badge-link-text} (die empfohlene Methode) und über [Snap-Pakete](https://snapcraft.io/immich){.badge-link-text}. Du wirst sehen, dass die Einrichtung mit etwas technischem Grundwissen gut zu bewältigen ist.
⚠️ **Wichtig:** 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.
```markdown ┌─────────────────────────────────────────────────┐ │ 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](https://docs.docker.com/engine/){.badge-link-text} und [Docker Compose](https://docs.docker.com/compose/){.badge-link-text} - **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](/de/netzwerk/dynamische-vs-statische-ip-adressen){.badge-link-text} 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](https://www.nginx.com/){.badge-link-text} oder [Traefik](https://traefik.io/){.badge-link-text})
💡 **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: ```bash 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: ```bash 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: ```bash 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: ```bash 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: ```bash 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: ```bash 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:** ```bash sudo snap services immich ``` **Die Ausgabe sollte in etwa so aussehen:** ```bash 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: ```bash 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:** ```bash 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: ```bash # 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: ```bash sudo ufw allow 2283/tcp # oder dein geänderter Port 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.
Nachdem die Installation abgeschlossen ist, kannst du auf die Immich-Weboberfläche `http://deine-server-ip:2283` 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:** ```bash 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: ```bash 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:** ```bash 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:** ```bash sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin ``` **Überprüfe, ob Docker korrekt installiert wurde:** ```bash 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:
```bash 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:** ```bash mkdir -p ~/immich cd ~/immich ``` **Lade die erforderlichen Dateien herunter:** ```bash 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:** ```bash 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:** ```bash # 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.
```markdown Docker-Compose-Umgebung ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ │ │ │ │ Immich │ │ Postgres │ │ Redis │ │ Server │ │ Datenbank │ │ Cache │ │ │ │ │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │ └───────────────┼────────────────┘ │ ┌──────▼──────┐ │ │ │ Volumes │ │ (Daten) │ │ │ └─────────────┘ ``` Immich starten Nachdem wir die Konfiguration angepasst haben, können wir Immich starten: ```bash 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:** ```bash docker compose logs -f ``` Drücke `Ctrl+C`, um die Log-Anzeige zu beenden. **Um zu überprüfen, ob alle Container laufen:** ```bash 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: ```bash 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: ```bash sudo nano /etc/systemd/system/immich.service ``` **Füge folgenden Inhalt ein:** ```bash [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:** ```bash 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: ![Screenshot der Admin-Registrierungsseite von Immich, auf der Benutzer ihre E-Mail, Passwort und Name zur Erstellung eines Administratorkontos eingeben.](/assets/media/posts/2025/immich_login.webp) 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. ![Anmeldebildschirm für die Immich-Anwendung mit E-Mail- und Passwortfeldern sowie dem Immich-Logo.](/assets/media/posts/2025/immich_admin.webp) 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** ```yaml - **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** ```yaml - **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](https://immich.app/docs/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/](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](https://play.google.com/store/apps/details?id=app.alextran.immich&hl=en-US&pli=1){.badge-link-text} oder [Apple App Store](https://apps.apple.com/de/app/immich/id1613945652){.badge-link-text} 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: ```bash 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: ```bash docker compose ps ```
⚠️ **Hinweis:** Alle Container sollten den Status `Up` haben.
**Snap-Dienst-Status**: Bei der Snap-Installation überprüfe den Status der Dienste: ```bash 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: ```bash docker compose logs ``` Um nur die Logs eines bestimmten Containers zu sehen, z.B. des Immich-Servers: ```bash docker compose logs immich-server ``` Für eine Echtzeitansicht der Logs (besonders nützlich bei der Fehlersuche): ```bash docker compose logs -f ``` #### Snap-Installation Bei der Snap-Installation kannst du die Logs mit dem `journalctl`-Befehl anzeigen: ```bash sudo journalctl -u snap.immich.* ``` Um nur die neuesten Logs zu sehen: ```bash 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: ```bash 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:** ```bash sudo snap revert immich ```
⚠️ **Wichtig:** Mache immer ein Backup deiner Daten, bevor du größere Änderungen vornimmst oder auf eine andere Version wechselst.
```markdown 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](https://immich.app/docs/){.badge-link-text} oder im [GitHub-Repository](https://github.com/immich-app/immich){.badge-link-text} 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](https://openvpn.net/){.badge-link-text} und [Wireguard](https://www.wireguard.com/){.badge-link-text}. **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: ```bash # 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](https://www.nginx.com/){.badge-link-text}, [Traefik](https://traefik.io/){.badge-link-text} oder [HAProxy](https://www.haproxy.org/){.badge-link-text} 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 ```bash 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:** ```bash # Datenbank-Backup erstellen sudo immich-distribution.backup -d ``` Die Backup-Dateien werden unter `/var/snap/immich-distribution/common/backups` gespeichert. **Bei der Docker-Installation:** ```bash # 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:** ```bash # 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:** ```bash # 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:** ```bash sudo snap info immich-distribution ``` Falls ein Update Probleme verursacht, kannst du zur vorherigen Version zurückkehren: ```bash sudo snap revert immich-distribution ``` Docker-Installation Bei der Docker-Installation musst du Updates manuell durchführen: ```bash 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: ```bash 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](https://immich.app/docs/){.badge-link-text} [GitHub Repository](https://github.com/immich-app/immich){.badge-link-text} [Discord-Server](https://discord.gg/D8JsnBEuKb){.badge-link-text} [Reddit-Community](https://www.reddit.com/r/immich/){.badge-link-text} [Immich Wiki](https://github.com/immich-app/immich/wiki){.badge-link-text} [Docker-Dokumentation](https://docs.docker.com/){.badge-link-text} [Ubuntu Server-Dokumentation](https://ubuntu.com/server/docs){.badge-link-text} [Nginx Proxy Manager](https://nginxproxymanager.com){.badge-link-text} [Duplicati](https://www.duplicati.com/){.badge-link-text} [Watchtower](https://containrrr.dev/watchtower/){.badge-link-text} [Let’s Encrypt](https://letsencrypt.org/){.badge-link-text} [Wireguard](https://www.wireguard.com/){.badge-link-text}
💡 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!