Die Problemumgehung der Quelle war für ein einzelnes Immich-Paket aus dem Jahr 2025 praktikabel, sollte jedoch nicht in einer aktuellen Upgrade-Anleitung unverändert übernommen werden. Ein Community-Mitglied änderte manuell die immich-server und immich-machine-learning Image-Tags auf v1.134.0. Der ursprüngliche Verfasser sagte, dass dies letztendlich auf seinem primären ZimaOS-System funktionierte, jedoch nicht auf einer Test-VM.
Immich ist inzwischen auf v3 umgestiegen, und das gepflegte Bereitstellungsmodell verwendet einen vollständigen Docker-Compose-Stack sowie den Wert IMMICH_VERSION. Wenn nur ein oder zwei Service-Tags aktualisiert werden, kann ein Stack mit gemischten Versionen entstehen, sobald sich Annahmen zu Datenbank, Cache, Machine Learning oder API geändert haben.
Die Quelle von 2025 bearbeitete die einzelnen Immich-Service-Tags
Die Community riet dem Benutzer, sowohl den Server als auch das Machine-Learning-Image zu ändern
CogZog sagte, beide immich-server und immich-machine-learning sollte den neuen Tag verwenden. Der Benutzer bestätigte, dass er beide geändert hatte, aber die Test-VM blieb weiterhin bei der älteren Version.
Der primäre ZimaOS-Build erreichte schließlich v1.134.0
Die Quelle legte keine Regel fest, das Datenbank-Image manuell zu aktualisieren
beep fragte, ob die Datenbank ebenfalls auf einen neueren/stabilen Tag umgestellt werden sollte. Die Antwort der Community lautete im Wesentlichen: „Wenn es nicht kaputt ist, repariere es nicht.“ Das war eine persönliche Einschätzung, keine Immich-Migrationsrichtlinie.
Die aktuelle Immich-Version ist v3 – mit einem vollständigen Compose-Aktualisierungspfad
Immich v3.0.0 wurde im Juli 2026 veröffentlicht. Laut Upstream soll der gepflegte Stack aktualisiert werden, indem IMMICH_VERSION=v3 und den normalen Compose-Pull-/Neu-Erstellungsprozess auszuführen und dabei auch die Hinweise zu den bahnbrechenden Änderungen und zur Migration in v3 zu prüfen.
Siehe die aktuellen Hinweise zum Immich-v3-Release.
Der Upstream empfiehlt derzeit das vollständige Docker-Compose-Bundle
Immichs aktuelle Installationsdokumentation weist Benutzer an, das Release herunterzuladen. docker-compose.yml und .env, legen Sie anschließend die Speicherorte fest und IMMICH_VERSION. Der Pfad der PostgreSQL-Datenbank sollte auf einem unterstützten lokalen Dateisystem und nicht auf einer Netzwerkfreigabe verbleiben.
Verwenden Sie Immichs aktuelles Compose-Modell für manuelle bzw. benutzerdefinierte Bereitstellungen.
Für das ZimaOS App-Store-Paket den aktuellen App-Update-Weg bevorzugen
Der aktuelle ZimaOS App Store 2.0 umfasst die Verwaltung von Updates installierter Apps. Wenn das Store-Paket ein Immich-Update anbietet, lassen Sie die Paketdefinition den gesamten Multi-Service-Stack aktualisieren, anstatt das Tag eines einzelnen Dienstes unabhängig zu bearbeiten.
Vor einem größeren Immich-Upgrade sichern
Sichern Sie sowohl die Foto-/Videobibliothek als auch den Datenbank- und Anwendungsstatus, bevor Sie eine größere Versionsänderung durchführen. Ein intaktes Bibliotheksverzeichnis allein reicht nicht aus, um Alben, Benutzer, Metadaten und den Anwendungsstatus wiederherzustellen.
Einen Immich-Stack mit gemischten Versionen vermeiden
Immich ist kein einzelner unabhängiger Container. Anwendung, Machine-Learning-Dienst, Datenbank und weitere unterstützende Komponenten werden als abgestimmte Release-Topologie getestet. Wenn ein Image aktualisiert wird, während ein anderes auf einem festen Stand bleibt, kann dies zu Inkompatibilitäten bei API, Schema oder Startvorgang führen.
Die Quelle funktionierte erst, nachdem der effektive Stack ausreichend auf die Ausführung von v1.134.0 abgestimmt war; sie belegt nicht, dass das beliebige Mischen von Tags sicher ist.
PostgreSQL auf unterstütztem lokalem Speicher belassen
Die aktuellen Immich-Anforderungen besagen, dass das PostgreSQL-Datenverzeichnis ein lokales Dateisystem verwenden und nicht auf einer Netzwerkfreigabe liegen sollte. Der Datenbankstatus ist im Vergleich zur Fotobibliothek in der Regel klein, aber für Benutzer, Alben, Metadaten und den Anwendungsstatus unverzichtbar.
Klären Sie, ob Sie das ZimaOS-Paket oder einen benutzerdefinierten Compose-Stack installiert haben
Wenn Immich aus dem ZimaOS App Store stammt, verwenden Sie den aktuellen Aktualisierungspfad des Stores und prüfen Sie dessen Paketänderungen. Wenn Sie Ihren eigenen Compose-Stack importiert haben, sind Sie für die Versionsfixierung im Upstream, .env, den Datenbankpfad und die Migrationsschritte.
Das Bearbeiten der App-Store-Einstellungen zusammen mit einem manuell gepflegten Upstream-Stack erschwert die künftige Fehlerbehebung.
Vorbereitungsprüfung für ein Major-Upgrade durchführen
- Bestätigen Sie, dass ein aktuelles Backup der Fotobibliothek vorhanden ist.
- Sichern Sie die Datenbank und den Anwendungsstatus.
- Notieren Sie die aktuelle Version und die Volume-Zuordnungen.
- Lesen Sie die Hinweise des Upstream-Projekts zu Änderungen mit inkompatiblen Auswirkungen.
- Stellen Sie sicher, dass auf dem System-/AppData-Laufwerk genügend freier Speicherplatz für das Abrufen von Images und Migrationen vorhanden ist.
Version und Aufgaben der laufenden Instanz nach der Aktualisierung überprüfen
Bleiben Sie nicht bei „Speichern abgeschlossen“ stehen. Öffnen Sie die Seite „Info/System“ von Immich, bestätigen Sie die Version des laufenden Servers, überprüfen Sie den Zustand der Container und verifizieren Sie anschließend Uploads, Miniaturansichten, Machine-Learning-Aufgaben und die Verbindung zur mobilen App.
Die Quelle selbst zeigt, warum: Das Bearbeiten des Tags bedeutete nicht sofort, dass die laufende Instanz tatsächlich aktualisiert worden war.
Ein Rollback besteht nicht immer nur darin, den Tag zurückzuändern
Sobald ein Major-Release das Datenbankschema oder den Status migriert hat, wird ein Downgrade eines Images möglicherweise nicht unterstützt. Befolgen Sie die Migrations-/Rollback-Anweisungen des Upstream-Projekts und verwenden Sie Backups, statt davon auszugehen, dass ein vorheriger Tag immer als universelle Rückgängig-Funktion dient.
Immich-Update-FAQ
Hat die manuelle Tag-Methode von 2025 beim primären System des Nutzers aus der Quelle funktioniert?
Ja, letztendlich. Ihre Test-VM verhielt sich jedoch nicht auf dieselbe Weise.
Sollten aktuelle Immich-Nutzer nur die Tags von immich-server und machine-learning aktualisieren?
Nein. Die aktuelle Version Immich v3 wird als vollständiger Compose-Stack mit Hinweisen zu Versionen und Migrationen verwaltet.
Hat IceWhale in der Quelle automatisierte Immich-Updates versprochen?
Nein. Zima-Giorgio sagte lediglich, dass das Team die Anfrage besprechen würde.
