Stelle Jellyfin nach einem fehlgeschlagenen Container-Update wieder her, indem du den persistenten Zustand schützt, bevor du die Laufzeitumgebung ersetzt, zurücksetzt oder neu erstellst.
Ein fehlgeschlagenes Update kann durch ein Image-Problem, eine geänderte Umgebungsvariable, eine verlorene Gerätezuordnung, einen Fehler bei einem Volume oder ein Problem bei der Anwendungsmigration verursacht werden. Sichere den fehlgeschlagenen Zustand und ermittle, welche Ebene geändert wurde. Die Wiederherstellung ist am sichersten, wenn das Konfigurationsverzeichnis unverändert bleibt, bis du weißt, ob die Laufzeitumgebung oder die Daten tatsächlich ausgefallen sind.
Fehlgeschlagenen Zustand vor einem weiteren Pull einfrieren
Deaktiviere automatische Updates und Neustartschleifen, damit jeder neue Versuch Protokolle, Image-Tags oder den Anwendungszustand nicht weiter verändert. Sichere die effektive Containerdefinition und den ersten schwerwiegenden Fehler.
Ein fehlgeschlagenes Upgrade lässt sich viel leichter rückgängig machen, wenn bereits ein Jellyfin-Backup vor der Änderung vorhanden ist. Ohne ein solches Backup kann ein Laufzeitfehler zu einem Problem bei der Zustandswiederherstellung werden.
Notiere Image-Digest, Mounts, Geräte, Umgebung, Netzwerkmodus und die aktuellen Protokolle. Führe keine Bereinigungs- oder Prune-Befehle aus, solange der Wiederherstellungssatz noch ermittelt wird.
Konfiguration und Datenbank vor einer Neuerstellung schützen
Das austauschbare Image sollte von der persistenten Jellyfin-Datenbank, der Konfiguration, den Metadaten und den Plugins getrennt werden. Erstelle eine schreibgeschützte Kopie oder einen Snapshot, bevor eine ältere oder neuere Binärdatei diesen Zustand erneut öffnet.
Konfigurationsbackups von Jellyfin schützen Benutzerkonten, Bibliothekseinstellungen, Wiedergabeverlauf und Metadaten unabhängig von der Medienbibliothek selbst.
Kopiere den persistenten Pfad an einen zweiten Speicherort und bewahre die Besitzrechte. Die Persistenzgrenze des Containers ist nur dann korrekt, wenn eine saubere Laufzeitumgebung die Verbindung wiederherstellen kann, ohne einen leeren Server zu erzeugen.
Die kleinste ausgefallene Ebene wiederherstellen
Wenn das alte Image mit demselben Zustand und denselben Mounts funktioniert, liegt der Fehler im Update-Pfad und nicht in der Bibliothek. Wenn beide Versionen fehlschlagen, solltest du nicht weiter zwischen Images wechseln, sondern Daten und Berechtigungen getrennt untersuchen.
Ein versionsspezifischer Jellyfin-Startfehler sollte von allgemeinen Änderungen an Speicher und Netzwerk getrennt werden.
Teste einen einzigen Rollback oder ein bekannt funktionierendes Image mit einer kopierten Zustandssicherung. Vermeide es, wiederholt Migrationen gegen die einzige Kopie der Datenbank zu erzwingen.
Identität, Bibliotheken und eine Wiedergabe prüfen, bevor du die Automatisierung fortsetzt
Ein Container, der den Status „running“ erreicht, ist erst dann vollständig wiederhergestellt, wenn die erwarteten Benutzer, Bibliotheken, Wiedergabestatus, Pfade und das Wiedergabeverhalten wieder vorhanden sind. Scans und begleitende Automatisierungen können neue Schreibvorgänge auslösen. Halte sie daher während der Validierung pausiert.
Ein ordnungsgemäßer Wiederherstellungstest überprüft das Verhalten der Anwendung nach der Wiederherstellung, statt eine erfolgreiche Dateiextraktion als Beweis zu betrachten.
Bestätige die Serveridentität, das Durchsuchen einer Bibliothek, eine Direct-Play-Wiedergabe, eine Transkodierung, falls verwendet, und einen Neustart. Aktiviere erst danach geplante Scans und automatische Updates wieder.
Support & Tipps
Mehr zum Lesen

Solltest du Jellyfin im laufenden Betrieb sichern oder den Dienst zuerst anhalten?
Bevorzuge Backups bei angehaltenen Diensten, um die Einfachheit zu wahren; verwende Live-Snapshots nur, wenn der Anwendungsstatus konsistent erfasst wird und Wiederherstellungen getestet sind.

Warum läuft Jellyfin heiß oder laut, wenn niemand streamt?
Leerlaufwärme deutet meist auf Hintergrundaktivitäten oder eine Auslastung durch einen gemeinsam genutzten Host hin. Ermitteln Sie daher den aktiven Prozess und die geplante Aufgabe,...

Wann sollten Sie Jellyfin neu aufsetzen, statt es zu reparieren?
Wähle bei Laufzeitabweichungen einen Neuaufbau statt einer Reparatur, wenn der persistente Zustand gesichert ist; führe keinen „Neuaufbau“ durch, indem du die einzige intakte Datenbank...

