[TUT] IMMICH - Perfekte Alternative zur Foto-App

Liebe Forengemeinde,
in diesem Tutorial stelle ich Euch eine Anleitung zur Verfügung, mit welcher Ihr die Anwendung IMMICH in kürzester Zeit installieren könnt. Voraussetzung für dieses Tutorial ist Portainer.

Vorbereitung

Editieren der Datei "stack.env":

1. Aufrufen der Anwendung IT-Tools zur Erzeugung eines zufälligen 128-Zeichen Strings
   • https://it-tools.tech/token-generator?length=128
     • Hinweis: Du kannst alternativ auch die IT-Tools lokal auf deinem NAS installieren
2. Auf den Button „Refresh“ und anschließend auf den Button „Copy“ klicken

1. Den Anhang "immich.zip" herunterladen und entpacken.
2. Im entpackten Ordner die Datei "stack.env" in einem Texteditor Eurer Wahl öffnen.
3. In dieser Datei die nachfolgenden (grün markierten) Werte entsprechend Eurer Umgebung ändern.
   Tipp: Der String aus dem "Token generator" kann in Zeile 25 mit dem Tastenkürzel [Strg]+[V] eingefügt werden.

This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.

Erklärung zu den Werten in obenstehender Abbildung:

This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.

3. Anschließend die Datei "stack.env" speichern und schließen.

Ermitteln von PUID und PGID:

1. Das Consolenfenster öffnen und per ssh auf Euer NAS verbinden (ssh muss natürlich aktiviert sein)
2. Als Admin anmelden
3. Folgende Befehle ausführen:
   • id -u (gibt die PUID zurück, im Beispiel 1000)
   • id -g (gibt die PGID zurück, im Beispiel 10)
4. PUID und PGID notieren, diese Werte brauchen wir gleich
5. Consolenfenster mit dem Befehl exit schließen

Anleitung:

1. Dateimanager öffnen
2. In den Ordner docker wechseln
3. Erstellen des Ordners "immich"
4. Wechseln in den Ordner "immich"
5. Erstellen der folgenden Unterordner:
   • redis, db, upload, cache, pcache, config
6. Dateimanager schließen
7. Im entpackten Ordner die Datei "immich.yml" in einem Texteditor Eurer Wahl öffnen
8. Alle Zeilen editieren, bei denen eine entsprechende #Bemerkung hinterlegt ist, DEN REST SO BELASSEN!
9. Speichern
10. Portainer öffnen
11. Im linken Menü "Stacks" anklicken
12. Auf der rechten Seite "+ Add Stack" anklicken
13. Bei "Name" "immich" eintragen
14. Den Inhalt in der Datei "immich.yml" kopieren (Strg + A und danach Strg + C)
15. Den Inhalt im Webeditor einfügen (Strg + V)
16. Nun auf den Button "Load variables from .env file" klicken
    
17. Die Datei "stack.env" auswählen und auf "Öffnen" klicken
18. Unter "Actions" auf "Deploy the Stack" klicken
19. Es werden nun insgesamt 4 Container installiert
    • Hinweis: Die Installation wird ca. 10-15 Minuten dauern, da ca. 3 Gb an Daten heruntergeladen werden
20. Nach Fertigstellung sollten die 4 Container mit dem Status "healthy" angezeigt werden

This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.

1. IMMICH kann nun im Browser wie folgt aufgerufen werden:
   • http://Deine-NAS-IP:2283 (z.B. http://192.168.178.99:2283)
2. Beim ersten Aufruf muss ein Admin-Account angelegt werden, dies sollte jedoch selbsterklärend sein

Einige TIPPS:

1. IMMICH Lizensierung-Satus (Immich kaufen) ausblenden:.
   Verwaltung > Einstellungen > Theme-Einstellungen > Benutzerdefiniertes CSS > Folgende Zeile eintragen:
   • .license-status { display: none !important; }
   • F5 drücken zur Aktualisiereung - Der Hinweis "Immich kaufen" ist nun verschwunden 🙂
2. Manchmal gibt es es ein paar unschöne Warnungen im LOG, welche man wie folgt beseitigen kann:
   2a. Consolenfenster öffnen und per ssh anmelden
   2b. nano /etc/sysctl.conf
   2c. Folgende Einträge am Ende der Datei (ohne -) einfügen:
   • net.core.rmem_max=7500000
   • net.core.wmem_max=7500000
   • net.ipv4.tcp_fastopen = 3
   • vm.overcommit_memory = 1
     2d. Speichern + Exit
     2e. Änderungen übernehmen mit: sudo sysctl -p

Wichtiger Hinweis:

Die 4 Container von IMMICH sollten NICHT mit Watchtower upgedatet werden, da sich IMMICH in einer starken Entwicklungsphase besfindet und bei neuen Versionen manchmal diverse, manuelle Änderungen durchgeführt werden müssen. Des Weiteren sind die 4 Container untereinander abhängig, Watchtower kann mit diesen Abhängigkeiten nicht zuverlässig umgehen.

Unter folgenden Links findet ihr weiterführende Informationen:

• IMMICH DEMO
  • Einführung
  • Roadmap
  • IMMICH auf GitHub
  • IMMICH auf dem Smartphone installieren und einrichten (Anleitung im Video ab Minute 9:03)

File

immich.zip

Vorkonfigurierte Docker-Stack-Datei im YAML-Format inklusive ENV-Datei, direkt einsatzbereit.

Willi

May 24, 2025 at 3:58 PM

Viel Spaß beim Installieren!

Hallo ↩  sasam

um Immich vollständig zu deinstallieren, reicht es, wenn du diese 4 Docker-Container löscht:

This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.

Quote

↩  sasam da UGOS meckert, dass dieser Ordner bereits vorhanden ist, obwohl er nicht vorhanden ist.

Erstellst du den Ordner wohl unter “Freigegebener Ordner”? Da muss er nämlich hin. Wenn UGOS meckert, schau bitte nochmal genau, ob nicht doch ein Ordner mit dem selben Namen vorhanden ist. Du kannst diesen Ordner aber auch anders benennen wenn du möchtest. Falls du einen anderen Namen wählst, dann muss aber auch die nachfolgend beschriebene Codezeile entsprechend angepasst werden (nur das Wort Medien vor dem :ro, der Rest bleibt gleich).

Der optionale Medienordner in der Datei “immich.yml” heißt “Medien”, dieser Ordner muss VOR der Installation unter “Freigegebener Order” im Dateimanager angelegt werden.

Das Volume-Mapping zu diesem Ordner erfolgt durch folgende Code-Zeile der Datei “immich.yml”:

- /volume1/Medien:/mnt/media/Medien:ro

Packe deine bisherigen Freigaben “Bilder, Bilder Smartphone, Bilder sonst irgendwas etc.” in den Ordner Medien und berechtige den Ordner “Medien” für deine Benutzer wie du es gerne hättest, so können sie auch außerhalb von Immich per Netzlaufwerk auf die Bilder zugreifen.

Den Ordner “Medien” kannst du nach der Installation als Admin in Immich wie folgt mappen/einbinden:

Anschließend auf das 3-Punkte-Menü klicken und die externe Bibliothek scannen:
This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.

Dann als Besitzer anmelden und andere Benutzer für den Zugriff auf die Freigabe “Medien” berechtigen, dies kannst du unter dem Menüpunkt "Partner-Sharing" erledigen:

LG Willi

↩  sasam

Die Codezeile aus der Datei immich.yml erstellt keinen Ordner im Filesystem von UGOS, sondern
mappt (= verbindet) lediglich einen vorhandenen Freigabeordner namens "Medien" in den Docker-Container.

- /volume1/Medien:/mnt/media/Medien:ro

Die Ursache dieser Meldung im UGOS Dateimanagers ist mir also nicht schlüssig, weil sie aus meiner Sicht in
keinem Zusammenhang mit der Installationsroutine steht.

Ich würde dir empfehlen, diesbezüglich ein Ticket bei technischen Support zu erstellen. Immich musst du
hierbei nicht erwähnen, sondern lediglich, dass du den Freigabeordner "Medien" nicht erstellen kannst.
Beschreibe den Fehler detailliert, am Besten fügst du dem Ticket deinenn Screenshot mit der Fehlermeldung
als Anhang bei. Du kannst das Ticket ohne Weiteres in deutscher Sprache erstellen, der technische Support
begrüßt dies sogar.

Zur Erstellung eines Tickets, am Homescreen deines NAS einfach auf Support klicken und nacheinander
den Schritten der nachfolgenden Screenshots folgen:

Wenn du dein NAS bereits registriert hast, kannst du dich mit deinen Zugangsdaten einloggen und das Ticket
mit einem Klick auf "Support-Ticket" erstellen:

Ansonsten klicke im Anmeldefenster rechts unten auf "Jetzt egistrieren" und folge dem Registrierungslink, der
dir danach per E-Mail zugeschickt wird und folge den Anweisungen am Bildschirm.

Der Support antwortet in der Regel relativ zügig, eine Rückmeldung bez. der Problemlösung wäre toll.
LG Willi

@"sasam"#150

Hierzu würde ich empfehlen, VPN auf deinem Router einzurichten. Das ist wohl die sicherste Methode, um von extern auf dein NAS zu Hause zuzugreifen. Ich finde diese Art von Zugriff auf jedem Fall sicherer, als die UgreenLink-Methode 😉.

Falls du eine Fritzbox hast, kannst du das in ein paar Minuten mit "Wireguard" umsetzen.
"Wireguard" hat auch eine App, in aktiviertem Zustand wärst du quasi von überall aus in deinem LAN zu Hause
und kannst immich (wie auch intern) per http://IP-Adresse:Port oder der Immich-App aus dem App-Store erreichen.

Schau dir mal diese Anleitung an:

• WireGuard-VPN zur FRITZ!Box am Smartphone oder Tablet einrichten

↩  sasam

Einfach in Portainer diese 4 Container stoppen:

This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.

Danach Stacks > immich > Editor >Update the Stack > "Re-pull Image and redeploy" einschalten > Update

Der Vorgang kann dann gute 10 Minuten oder länger dauern, es werden einige Gigabyte heruntergeladen.

Nach dieser Erfolgsmeldung hast du dann die neuseste Version von Immich:

Fertig.

Quote from rusty

Bei mir werden die Bilder nur einseitig synchronisiert

In der Immich.yml wird der Ordner "Medien" mit der Berechtigung "Read-Only", also nur lesendem Zugriff gemappt.
Wenn immich schreibenden Zugriff auf den externen Medienordner haben soll, dann einfach den Part :ro in der Codezeile
für das Mapping entfernen und den Stack erneut ausführen.

/volume1/Medien:/mnt/media/Medien:ro ändern in /volume1/Medien:/mnt/media/Medien

Quote from Kova0001

so sieht der Eintrag jetzt aus...

volumes:
- /volume1/Medien:/mnt/media/Kovatech-Fotos #Pfad zu externen Medien (optional)

Diese Zeile ist falsch. Sofern sich dein Freigabeordner "Kovatech-Fotos" direkt (also nicht als Unterordner) auf dem Volume 1 befindet, musst du die Zeile wie folgt anpassen (die Syntax für ein Volume-Mapping lautet immer Freigabepfad:Containerpfad):

volumes:
- /volume1/Kovatech-Fotos:/mnt/media/Kovatech-Fotos

Tipp: den korrekten Freigabepfad (Abschnitt vor dem Doppelpunkt) findest du heraus, indem du in den Dateimanager wechselst, dann per rechter Maustaste auf deinen Ordner klickst und Eigenschften wählst. Unter "Ort" wird der korrekte Pfad angezeigt, welcher sich mit einem Klick auf "Link kopieren" gleich in die Zwischenablage befördern lässt:

This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.

Du musst nun also wie folgt vorgehen:

1. Diese 4 Container stoppen

This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.

2. Danach Stacks > immich > Editor > Zeile anpassen > Update the Stack > "Re-pull Image and redeploy" ausschalten > Update

3. Bei erfolgreicher Fertigstellung mit den Schritten aus Beitrag #3 ab dem Punkt "Den Ordner “Medien” kannst du nach der Installation als Admin in Immich wie folgt mappen/einbinden:", fortfahren (der beschriebene Ordner "Medien" ist in deinem Fall der Ordner "Kovatech-Fotos", dass musst du bei der Umsetzung berücksichtigen).

LG Willi