So stellen Sie Immich nach einem fehlgeschlagenen Container-Update wieder her

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Stelle Immich nach einem fehlgeschlagenen Container-Update wieder her, indem du die aktuellen Belege sicherst, jeden Immich-Dienst auf die zuletzt nachweislich funktionierende Version festsetzt und Daten nur dann wiederherstellst, wenn sich der Stack mit einem koordinierten Rollback nicht starten lässt.

Ein Update kann gleichzeitig den Anwendungscode, die erwarteten Datenbankschemata, Umgebungsvariablen und Versionen der Begleitdienste ändern. Wenn du wiederholt die neuesten Images herunterlädst oder alte und neue Container mischst, wird die Wiederherstellungsgrenze schwerer erkennbar. Sichere die Compose-Datei, die Umgebung, Logs, Datenbank und Upload-Pfade, bevor du etwas unternimmst. Entscheide dann zwischen einem Image-Rollback und einer vollständigen Wiederherstellung von Datenbank und Bibliothek.

Sichere den fehlerhaften Zustand und ermittle die Versionsgrenze des Updates

Deaktiviere automatische Neustarts und notiere die genauen Images oder Digests für Server, Machine Learning, Datenbank und Cache. Sichere die Start-Logs und Deployment-Dateien, bevor du erneut ein Image herunterlädst. Erfolgreich ist dieser Schritt, wenn du genau benennen kannst, was geändert wurde. Andernfalls sollte die Wiederherstellung pausieren, bis sich die alten Versionen anhand der Deployment-Historie oder lokaler Images ermitteln lassen.

Prüfe, ob der Server beendet wird, bevor er eine Verbindung zur Datenbank herstellt, während einer Migration oder nachdem er betriebsbereit ist. Ein Fehler bei der Verbindung zu einer Abhängigkeit deutet auf ein Problem mit dem Netzwerk, den Zugangsdaten oder dem Betriebszustand hin. Ein Migrationsfehler erhöht das Risiko, nur das App-Image wiederherzustellen, da die Datenbank bereits geändert worden sein könnte.

Eine Anleitung zu versionsgebundenen Immich-Updates zeigt, warum die Versionsgrenze und die Deployment-Dateien wichtig sind. Nutze sie, um den Übergang zu erfassen, aber betrachte deine eigenen Logs und Backups als maßgebliche Grundlage für den Rollback.

Versuche zuerst einen vollständigen Rollback auf die zuletzt nachweislich funktionierenden Images

Setze alle Immich-Anwendungsimages auf genau die zuvor funktionierende Version zurück, statt nur einen einzelnen Dienst zu ändern. Erstelle die betroffenen Container neu, ohne die persistenten Volumes anzutasten. Wenn der Stack wieder fehlerfrei läuft und die Logs keine Schema-Inkompatibilität zeigen, ist dieser Rollback mit wenigen Änderungen erfolgreich.

Wenn der alte Server das aktuelle Datenbankschema ablehnt, halte an. Verwende nicht abwechselnd verschiedene Versionen mit derselben Datenbank und bearbeite die Migrationstabellen nicht manuell. Dieser Fehler bedeutet, dass das Update eine Datengrenze überschritten hat. Für die Wiederherstellung muss ein Datenbank-Backup verwendet werden, dessen Zeitstempel zur ausgewählten Anwendungsversion passt.

Ein Bericht zu Immich v1.135.3 dokumentiert einen konkreten Fehler beim Start nach einem Update, der durch eine Datenbankmigration verursacht wurde. Das Beispiel für eine begrenzte Migration zeigt, warum der erste schwerwiegende Fehler sorgfältig geprüft werden sollte; es ist keine Erlaubnis, die Befehle aus diesem Fall in einer anderen Version zu verwenden.

Datenbank und Medien nur wiederherstellen, wenn ein Rollback nicht funktioniert

Erstelle vor der Wiederherstellung eine Sicherheitskopie oder einen Speicher-Snapshot des fehlgeschlagenen Zustands. Richte ein sauberes Wiederherstellungsziel ein, spiele die Datenbanksicherung ein und stelle anschließend die zugehörige Upload-Bibliothek sowie die erforderlichen Bereitstellungsdateien bereit. Überschreibe nicht die einzige aktuelle Bibliothek mit einer älteren Kopie, nur um Zeitstempel anzugleichen.

Datenbankeinträge und Asset-Dateien müssen dieselbe Sammlung abbilden. Wenn die Sicherung älter ist als die letzten Uploads, bewahre diese neueren Dateien separat auf, um sie später abzugleichen. Eine Wiederherstellung gilt als erfolgreich, wenn die Migrationen abgeschlossen sind, die erwarteten Nutzer und Assets angezeigt werden und sich Stichproben der Originale öffnen lassen, ohne dass weitverbreitete Fehler wegen fehlender Dateien auftreten.

Die Immich-Migrationsanleitung von ZimaSpace bietet eine nützliche Bestandsaufnahme für die Migration persistenter Komponenten, ohne ein Container-Image mit der Fotobibliothek selbst gleichzusetzen.

Single board computer zimaboard2

Wiederherstellung validieren, bevor du das Update erneut versuchst

Teste die Anmeldung, das Durchsuchen der Timeline, den Download von Originalen, die Thumbnail-Erstellung, Smart Search, die Gesichtsverarbeitung, einen neuen Upload und eine Datenbanksicherung. Starte die Container und den Host jeweils einmal neu. Der Test ist bestanden, wenn nach dem Neustart dieselben Assets und Funktionen verfügbar sind und keine wiederkehrenden Migrations- oder Berechtigungsfehler auftreten.

Kennzeichne den fehlgeschlagenen und den wiederhergestellten Zustand bis zum Abschluss der Validierung getrennt. Wenn die Wiederherstellung von einer älteren Version abhängt, deaktiviere unbeaufsichtigte Image-Pulls und dokumentiere die Versionsfixierung. Versuche das Update erst erneut, nachdem du alle dazwischenliegenden Releases geprüft und eine neue koordinierte Sicherung erstellt hast.

Rolle auf das gesicherte Wiederherstellungsziel zurück, wenn ein neuer Upload verschwindet, sich Originale nicht öffnen lassen oder Jobs wiederholt abstürzen. Eskaliere den Fall mit Quell- und Zielversionen, Image-Digests, dem ersten schwerwiegenden Logeintrag, dem Zeitstempel der Datenbanksicherung und der Speicherzuordnung; gib die letzte bekanntermaßen funktionierende Kopie nicht auf, solange die Update-Kompatibilität ungeklärt ist.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.