Wenn Immich unter ZimaOS nach der Bearbeitung ausschließlich des immich-server-Image-Tags auf einer alten Version bleibt, ändern Sie nicht weiter jeweils nur einen Container, sondern ermitteln Sie zuerst das Paket bzw. den Stack. Immich ist eine Anwendung mit mehreren Diensten; Server-, Machine-Learning-, Datenbank- und Cache-Komponenten müssen kompatibel bleiben, und einige ZimaOS-Pakete werden von unterschiedlichen App-Store-Quellen gepflegt.
Der Quellthread zeigt, warum eine Aktualisierung eines einzelnen Feldes fehlschlagen kann: Der Benutzer änderte das Server-Image, sah Netzwerkaktivität beim Herunterladen, startete neu, und Immich meldete weiterhin v2.6.1. Ein anderer Benutzer zeigte ein funktionierendes v3.1.0-Setup mit übereinstimmenden Dienst-Images. Die richtige Vorgehensweise lautet daher „sichern, den Stack ermitteln, konsistent aktualisieren, überprüfen“ und nicht „eine neuere Zahl in ein einzelnes Feld eingeben“.
Schritt 1: Ermitteln Sie, welches Immich-Paket Sie installiert haben
ZimaOS kann offizielle sowie Pakete von Drittanbieter- und Community-Stores enthalten. Öffnen Sie die App-Einstellungen und notieren Sie jedes Dienst-Image, nicht nur immich-server.
Beachten Sie außerdem die Quelle des App Stores, damit Sie wissen, wer die Aktualisierungsmetadaten kontrolliert.
Schritt 2: Sichern Sie Immich vor jedem größeren Update
Sichern Sie die Fotobibliothek und die PostgreSQL-Datenbank. Die aktuelle Anleitung zur Sicherung und Wiederherstellung von Immich dokumentiert einen Workflow zum Erstellen eines Datenbank-Dumps.
Betrachten Sie die Neuerstellung eines Containers nicht als Backup.
Schritt 3: Überprüfen Sie die Versionen aller Dienste
Der Quellenvergleich enthielt:
- Immich-Server;
- Immich-Machine-Learning;
- Postgres;
- Valkey/Redis.
Notieren Sie die vollständigen Image-Tags. Wenn der App Store sie als getestetes Bundle verwaltet, verwenden Sie bevorzugt dessen Aktualisierungsfunktion, anstatt eine Komponente manuell vor den anderen zu aktualisieren.
Schritt 4: Verwenden Sie die Aktualisierung im App Store, sofern verfügbar
Die aktuelle ZimaOS-Dokumentation besagt, dass das neueste Immich-Paket aus dem App Store installiert werden kann. Wenn eine Schaltfläche zum Aktualisieren verfügbar ist, verwenden Sie sie, damit auch die Compose-Definition des Paketbetreibers aktualisiert wird.
Die aktuelle Immich-Anleitung für ZimaOS ist der aktuelle offizielle Ausgangspunkt für ZimaOS.
Warum das Bearbeiten eines einzelnen Tags scheinbar einen Download auslöst, aber kein Update durchführt
Der App-Manager lädt möglicherweise ein neues Image herunter, erstellt den Dienst jedoch anhand von Store-Metadaten, einem anderen gespeicherten YAML-Wert oder einer anderen Image-Definition neu. Der laufende Container kann daher zum alten Tag zurückkehren.
Prüfen Sie das tatsächlich laufende Image mit:
docker ps --format '{.Names} {.Image}'Überspringen Sie nicht blind mehrere Immich-Hauptversionen
Immich-Releases können Änderungen an Datenbank/Schema und Diensten enthalten. Lesen Sie die Upstream-Release-/Upgrade-Hinweise für die Versionen, die Sie überspringen. Aktualisieren Sie den Stack als Einheit, statt kompatible Kombinationen zu erraten.
Wenn Sie ein BigBear- oder anderes Drittanbieterpaket verwenden
Ein separater Leitfaden der ZimaSpace-Community dokumentiert, dass das Ändern von Image-Tags bei einigen BigBear-Paketen funktioniert hat, während spätere Nutzer feststellten, dass derselbe Trick nicht bei allen Paketen anwendbar war. Ermitteln Sie die Paketquelle, bevor Sie diese Umgehung anwenden.
Der Immich-Update-Leitfaden erläutert diese paketspezifische Abgrenzung.
Update nach der Neuerstellung des Stacks überprüfen
Überprüfen Sie drei Stellen:
- die Tags der tatsächlich laufenden Docker-Images;
- die eigene Server-Versionsanzeige von Immich;
- Container-Logs auf Migrationen oder Kompatibilitätsfehler prüfen.
Löschen Sie nicht die Datenbank oder den Upload-Ordner, um ein Update zu erzwingen
Das Entfernen von Volumes ist ein destruktives Zurücksetzen und keine Update-Methode. Bewahren Sie die Datenbank und die Fotobibliothek auf, es sei denn, Sie haben ein getestetes Backup und möchten absichtlich eine frische Installation.
FAQ
Warum zeigt Immich nach der Änderung des Server-Tags weiterhin 2.6.1 an?
Möglicherweise erstellt die App die alte Dienstdefinition erneut, oder der Stack wurde nicht einheitlich aktualisiert. Prüfen Sie das tatsächlich laufende Image und die Paketquelle.
Sollte Machine Learning exakt zur Serverversion passen?
Halten Sie sich an die getesteten Versionen in der Immich-Release-/Compose-Definition, die Sie bereitstellen. Erfinden Sie keine unabhängigen Tags für die einzelnen Dienste.
Kann ich nur immich-server aktualisieren?
Vermeiden Sie das als Standardvorgehen. Immich ist ein Stack aus mehreren Diensten, und Upgrades können abgestimmte Änderungen erfordern.
Was sollte ich zuerst sichern?
Die PostgreSQL-Datenbank sowie Ihr Medien-/Upload-Speicher. Überprüfen Sie das Backup vor Änderungen an der Hauptversion.
