Wenn die in ZimaOS angezeigte Immich-Version älter als das Upstream-Immich-Release ist und der App Store keine Schaltfläche „Aktualisieren“ anbietet, gibt es Möglichkeiten, die Container manuell zu aktualisieren – die richtige Methode hängt jedoch davon ab, welches ZimaOS-Immich-Paket Sie installiert haben. Der IceWhale-Community-Thread vom Dezember 2025 bestätigte eine einfache Änderung des Image-Tags für das BigBear-Immich-Paket, während spätere Antworten zeigten, dass derselbe Trick nicht zuverlässig jedes andere Immich-Paket aktualisierte.
Die Methode aus der Community bestand darin, die App-Einstellungen zu öffnen und nur die immich-server und immich-machine-learning Image-Tags auf das Ziel-Release zu setzen und dabei die Tabs für Datenbank und Redis unverändert zu lassen. Der ursprüngliche Verfasser bestätigte, dass das Update reibungslos verlief, und ein anderer BigBear-Nutzer wechselte später erfolgreich von v2.3.1 auf v2.4.1. Die aktuelle Immich-Dokumentation verlangt jedoch, dass Administratoren die Versionshinweise lesen, die Datenbank sichern und Compose-/Datenbankänderungen vor dem Upgrade berücksichtigen. Das manuelle Ändern von Tags sollte daher nicht als universeller „immer sicherer“ Update-Schalter betrachtet werden.
Identifizieren Sie zuerst, welches Immich-Paket Sie installiert haben
Der Thread enthält mindestens zwei Bereitstellungspfade:
- BigBear Immich: Mehrere Nutzer berichteten, dass das Bearbeiten der Image-Tags in ZimaOS erfolgreich ein Update auslöste.
- Ursprüngliches/Nicht-BigBear-Paket: Ein späterer Nutzer berichtete, dass er selbst nach dem manuellen Ändern der Server- und Machine-Learning-Versionen bei v2.1.0 festhing.
Öffnen Sie die Immich-App-Einstellungen in ZimaOS und notieren Sie die aktuellen Imagenamen, Tags, Volume-Zuordnungen, das Datenbank-Image und die Umgebungsvariablen, bevor Sie Änderungen vornehmen. Gehen Sie nicht davon aus, dass eine Anleitung für die BigBear-Definition zu einer anderen App-Store-Vorlage passt.
Das BigBear-Tag-Update, das in der Community funktionierte
Das erfolgreiche Verfahren aus der Community war:
- Öffnen Sie auf dem ZimaOS-Dashboard das Drei-Punkte-Menü der Immich-App.
- Wählen Sie Einstellungen.
- Öffnen Sie den Tab immich-machine-learning.
- Ändern Sie den Tag des Images auf das gewünschte Immich-Release.
- Öffnen Sie den Tab immich-server.
- Legen Sie dort dasselbe Release-Tag fest.
- Lassen Sie die Tabs für die Datenbank und Redis unverändert, sofern die Versionshinweise nicht ausdrücklich eine Änderung an Datenbank oder Container erfordern.
- Speichern Sie die Konfiguration und lassen Sie ZimaOS die betroffenen Container neu erstellen bzw. abrufen.
Zum Zeitpunkt der ursprünglichen Antwort lautete der Beispiel-Tag:
v2.3.1Diese Version ist historisch. Ein anderer Nutzer aktualisierte später auf v2.4.1, und in einer Antwort vom April 2026 wurde erwähnt v2.7.4. Kopieren Sie heute keine dieser alten Versionsnummern. Wählen Sie eine Zielversion erst, nachdem Sie die aktuellen Immich-Versionshinweise und Ihren Upgrade-Pfad geprüft haben.
Was der ursprüngliche Verfasser bestätigte
Nach Erhalt der BigBear-Tag-Anleitung antwortete MikeFrizz, dass der Hinweis sehr hilfreich war und das Update reibungslos abgeschlossen wurde. Dies ist das am stärksten bestätigte Ergebnis im ursprünglichen Thread.
Diese Bestätigung stützt die Methode für das beim ursprünglichen Verfasser verwendete Paket und den entsprechenden Versionskontext. Sie beweist nicht, dass das manuelle Bearbeiten von zwei Tags für jede künftige Immich-Hauptversion oder jedes ZimaOS-Paket ausreicht.
Nicht davon ausgehen, dass das „latest“-Tag das Problem löst
Ein Benutzer änderte das Tag zu latest, aber ZimaOS kehrte wiederholt zur zuvor installierten Version zurück. Der Thread enthält anschließend Vermutungen, etwa den Versuch, Release, aber es gibt keine quellenbestätigte allgemeingültige Lösung auf Grundlage dieser generischen Tag-Namen.
Die aktuelle Immich-Dokumentation verwendet eine explizite Versionsvariable und unterstützt in ihrem eigenen Docker-Compose-Workflow Metatags für Hauptversionen. Verwenden Sie bei einer paketierten ZimaOS-App das Tag-Format, das die Paketdefinition und das Upstream-Image tatsächlich unterstützen. Erfinden Sie keine Tags, nur weil eine Bezeichnung plausibel klingt.
Immich vor Versionsänderungen sichern
Die aktuelle Immich-Dokumentation empfiehlt ausdrücklich, die Datenbank vor Aktualisierungen zu sichern, die Migrationen umfassen können. Auch Ihre Fotos und Videos benötigen eine unabhängige Sicherungsstrategie; ein Datenbank-Backup ersetzt die Mediathek selbst nicht.
Verwenden Sie vor einem manuellen Versionssprung den aktuellen Immich-Leitfaden zur Sicherung und Wiederherstellung.
Mindestens Folgendes sichern:
- das Backup der Immich-Datenbank;
- die Mediendaten der Bibliothek bzw. der Uploads;
- die aktuelle ZimaOS-App-Konfiguration und Volume-Zuordnungen;
- die aktuellen Image-Tags;
- und alle Umgebungsvariablen oder benutzerdefinierten Speicherorte.
Vor jedem Versionssprung die Immich-Release-Notes lesen
Die aktuelle Immich-Dokumentation zur Aktualisierung besagt, dass Administratoren vor einer Aktualisierung die Release Notes auf Breaking Changes prüfen sollten. Der normale Docker-Compose-Prozess des Upstream-Projekts lautet:
docker compose pull && docker compose up -daber erst, nachdem die Compose-Definition und die Versionsvariablen für das Ziel-Release geeignet sind.
Siehe den aktuellen Immich-Leitfaden zur Aktualisierung.
Das ist für ZimaOS relevant, weil eine paketierte App nicht nur bei den Image-Tags hinterherhinken kann, sondern auch bei ihrer Compose-ähnlichen Definition. Ein neueres immich-server Das Image kann Änderungen an Datenbank, Umgebung, Health-Checks oder Volumes voraussetzen, die ein älteres Paket nicht enthält.
Immich-Server- und Machine-Learning-Versionen kompatibel halten
Die Community hat speziell die Tags für beide geändert immich-server und immich-machine-learningAuch die aktuelle Immich-Dokumentation warnt davor, dass Versionsabweichungen zwischen dem Hauptserver und den Komponenten für maschinelles Lernen zu Fehlern oder Instabilität führen können.
Aktualisieren Sie nicht nur eines der beiden, weil dafür zufällig zuerst ein verfügbares Image angezeigt wurde. Behandeln Sie sie als eine koordinierte Anwendungsversion, sofern die aktuelle Release-Dokumentation nicht ausdrücklich etwas anderes vorgibt.
Ändern Sie den Tag des Datenbank-Containers nicht wahllos
Der Community-Rat, den Datenbank-Tab unverändert zu lassen, war für die dort besprochenen genauen BigBear-Minor-Updates sinnvoll. Die PostgreSQL-Schicht von Immich verfügt über eigene Migrationen und hat sich im Laufe der Zeit verändert, einschließlich der Migration von älteren Vektorerweiterungen zu VectorChord.
- Aktualisieren Sie das Datenbank-Image nicht nur, damit alle Tags numerisch ähnlich aussehen.
- Gehen Sie nicht davon aus, dass sich das Datenbank-Image niemals ändern darf. Wenn die aktuellen Immich-Versionshinweise eine Datenbank-/Compose-Migration erfordern, befolgen Sie stattdessen diese dokumentierte Migration.
Was ist, wenn die ursprüngliche Immich-App unter ZimaOS auf einer alten Version bleibt?
Eine Antwort vom März 2026 besagte, dass der Nutzer nicht die BigBear-App-Store-Version verwendete und selbst nach dem manuellen Versuch, die Machine-Learning- und Server-Images zu aktualisieren, bei Immich v2.1.0 festhing. Der Thread enthält keine bestätigte Lösung für die ursprüngliche Paketbereitstellung dieses Nutzers.
Das ist eine wichtige Grenze: Wenn das manuelle Ändern der Image-Tags die App nicht aktualisiert, wiederholen Sie nicht einfach denselben Vorgang. Vergleichen Sie die aktuelle Container-Definition des Pakets mit den aktuellen Compose-Anforderungen von Immich und ziehen Sie eine Migration zu einem gepflegten ZimaOS-Paket erst in Betracht, nachdem Sie eine Sicherung erstellt und die Datenpfade bestätigt haben.
Deinstallieren Sie ein funktionierendes Immich-Paket nicht, bevor Sie wissen, wo dessen Datenbank- und Medien-Volumes gespeichert sind.
Warum Community-Nutzer das BigBear-Immich-Paket empfahlen
Die erste Antwort empfahl die BigBear-Immich-App, weil sie in der Regel näher an den Upstream-Versionen gehalten wurde. Die später erfolgreichen Anweisungen zum Bearbeiten der Tags wurden ebenfalls ausdrücklich mit BigBear getestet.
Das macht „BigBear neu installieren“ nicht zu einem sicheren Ein-Klick-Migrationspfad für eine vorhandene Bibliothek. Ein neues Paket kann andere Volume-Namen, Datenverzeichnisse, Datenbank-Images oder Umgebungsvariablen verwenden. Behandeln Sie die Paketmigration als separaten Vorgang und nicht als Aktualisierung eines bestehenden Stacks.
Vorsicht bei automatischen Container-Updatern
Eine Community-Antwort vom April 2026 schlug Tugtainer als einfachere Alternative zu Watchtower vor, um Container zu prüfen und automatisch zu aktualisieren. Dieser Vorschlag kann für zustandslose Dienste praktisch sein, aber Immich ist eine zustandsbehaftete Anwendung mit mehreren Containern, einer PostgreSQL-Datenbank und dokumentierten Upgrade-Pfaden für inkompatible Änderungen.
Bei Immich kann der automatische Austausch von Images ohne das Lesen der Versionshinweise riskant sein. Die aktuelle Immich-Dokumentation weist Administratoren ausdrücklich darauf hin, vor Upgrades mögliche inkompatible Änderungen zu berücksichtigen. Wenn Sie überhaupt einen automatischen Container-Updater verwenden, bevorzugen Sie für Immich Benachrichtigungen und eine manuelle Genehmigung, statt blind jeden neuen Tag zu aktualisieren.
Sicherer Workflow für Immich-Updates unter ZimaOS
- Notieren Sie, ob das installierte Paket BigBear oder eine andere Immich-Definition ist.
- Notieren Sie die aktuellen Images/Tags für Server, Machine Learning, Datenbank und Redis.
- Sichern Sie die Immich-Datenbank und wichtige Medien.
- Lesen Sie die Upstream-Versionshinweise für jede Grenze mit inkompatiblen Änderungen zwischen Ihrer aktuellen Version und der Zielversion.
- Bestätigen Sie, ob die Zielversion Änderungen an Compose, der Datenbank, Umgebungsvariablen oder dem Speicher erfordert.
- Ändern Sie bei einem kompatiblen BigBear-Minor-Update die Server- und Machine-Learning-Tags gemeinsam, wie es die Community getan hat.
- Lassen Sie die Datenbank-/Redis-Images unverändert, sofern der dokumentierte Upgrade-Pfad nicht ausdrücklich eine Änderung erfordert.
- Speichern Sie die App-Einstellungen und beobachten Sie die Containerprotokolle, während die neuen Images gestartet werden.
- Überprüfen Sie die Version der Immich-Weboberfläche, Uploads, Thumbnails, Machine Learning und die vorhandene Bibliothek, bevor Sie alte Images löschen.
- Wenn das Paket sofort zurückgerollt wird oder auf der alten Version bleibt, überprüfen Sie die Paketdefinition, anstatt wiederholt Tags zu erzwingen.
Was nach einem Immich-Update überprüft werden sollte
- Die Weboberfläche wird geladen und zeigt die vorgesehene Serverversion an.
- Die mobile App kann eine Verbindung herstellen und ist mit der Server-Hauptversion kompatibel.
- Vorhandene Fotos und Videos lassen sich korrekt öffnen.
- Neue Uploads werden erfolgreich abgeschlossen.
- Thumbnail- und Transkodierungsaufträge werden ausgeführt.
- Die Machine-Learning-Funktionen starten ohne Fehler aufgrund von Versionskonflikten.
- Der PostgreSQL-Container bleibt fehlerfrei.
Die aktuelle Immich-Dokumentation weist darauf hin, dass ein Downgrade keine unterstützte Wiederherstellungsstrategie ist. Ein Backup ist sicherer, als anzunehmen, dass Sie den Tag nach einer Datenbankmigration einfach zurücksetzen können.
FAQ zum Immich-Update unter ZimaOS
Kann ich Immich aktualisieren, indem ich die ZimaOS-Image-Tags ändere?
Ja, für einige Paket-/Versionskombinationen. Der ursprüngliche Verfasser und ein weiterer BigBear-Nutzer bestätigten, dass die Änderung beider Server- und Machine-Learning-Tags funktionierte. Im Thread wird außerdem ein Nicht-BigBear-Nutzer erwähnt, bei dem die Methode die veraltete Installation nicht beheben konnte.
Welche Immich-Tags sollte ich ändern?
Bei der bestätigten BigBear-Community-Methode wurden die immich-server und immich-machine-learning Tags gemeinsam geändert wurden. Übernehmen Sie die alten Beispiele v2.3.1, v2.4.1 oder v2.7.4 nicht als aktuelle Zielversionen.
Sollte ich latest verwenden?
Nicht als allgemeingültige Lösung. Ein Nutzer im Thread berichtete, dass latest hat nicht funktioniert. Verwenden Sie das von Ihrem tatsächlichen Paket und der aktuellen Immich-Dokumentation unterstützte Versionsschema.
Kann ich einfach docker pull ausführen?
Das alleinige Herunterladen eines neuen Images erstellt den laufenden Container nicht neu und übernimmt keine Compose-Änderungen. Immich verwendet upstream docker compose pull && docker compose up -d nachdem die Konfiguration für die Zielversion vorbereitet wurde.
Sollten Tugtainer oder Watchtower Immich automatisch aktualisieren?
Automatische Updates können die von Immich ausdrücklich empfohlene Prüfung der Versionshinweise und Migrationen überspringen. Bei einer zustandsbehafteten Anwendung mit Datenbank sind Benachrichtigungen und kontrollierte manuelle Upgrades sicherer als ein blindes automatisches Ersetzen.
Benötige ich vor einem Immich-Update ein Backup?
Ja. Die aktuellen Upgrade- und Backup-Dokumentationen von Immich empfehlen, die Datenbank vor Upgrades zu schützen. Unersetzliche Medien sollten Sie zusätzlich separat sichern.
