So verhinderst du den Verlust der Jellyfin-Konfiguration bei Upgrades

Eva Wong

IceWhale author

Eva Wong ist die Technische Redakteurin und und leidenschaftliche Tüftlerin bei ZimaSpace. Eine lebenslange Geek mit einer Leidenschaft für Homelabs und Open-Source-Software, sie spezialisiert sich darauf, komplexe technische Konzepte in zugängliche, praktische Anleitungenzu übersetzen. Eva ist der Meinung, dass Self-Hosting Spaß machen und nicht einschüchternd sein sollte. Durch ihre Tutorials befähigt sie die Community, Hardware-Setups zu entmystifizieren, vom Bau ihres ersten NAS bis hin zur Beherrschung von Docker-Containern.

How to Prevent Jellyfin Configuration Loss During Upgrades - Zima Store Online

Verhindern Sie den Verlust der Jellyfin-Konfiguration während Upgrades, indem Sie den Anwendungsstatus und die austauschbare Laufzeitumgebung als zwei separate Wiederherstellungsobjekte behandeln.

Ein Upgrade kann auf Paketebene erfolgreich sein, während ein geänderter Mount, eine Benutzer-ID, eine Gerätezuordnung oder eine Migration dazu führt, dass Jellyfin wie eine neue Installation aussieht. Der Präventionsschritt besteht nicht abstrakt darin, „ein Backup zu erstellen“, sondern genau zu wissen, wo der Status gespeichert ist, ihn konsistent zu sichern, die laufende Definition zu dokumentieren und die Wiederherstellung nachweislich zu testen.

Ermitteln Sie vor dem Upgrade die tatsächlich persistenten Pfade

Gehen Sie nicht davon aus, dass der in einem Container angezeigte Pfad dem Host-Pfad entspricht, der gesichert wird. Überprüfen Sie den Bind-Mount oder das benannte Volume, das Datenbank, Konfiguration, Metadaten und Plugin-Status tatsächlich enthält.

Der Container-Speicher bleibt portabel, wenn Volume-Definitionen und Service-Grenzen in der Bereitstellungskonfiguration eindeutig festgelegt sind.

Notieren Sie für jeden persistenten Mount den Host-Pfad, den Container-Pfad, die Eigentümerschaft und das Dateisystem. Wenn sich der Speicherort des Status nicht zuverlässig bestimmen lässt, verschieben Sie das Upgrade.

Erstellen Sie eine konsistente Kopie vor der Änderung

Der nützlichste Wiederherstellungspunkt wird erstellt, bevor die neue Version die Datenbank ändern kann. Eine Dateikopie während aktiver Schreibvorgänge ist möglicherweise weniger vertrauenswürdig als ein Backup bei angehaltenem Dienst oder ein konsistenter Snapshot.

Ein separates Jellyfin-Konfigurations-Backup bewahrt den nur schwer reproduzierbaren Status, während die umfangreichen Mediendateien über einen eigenen Sicherungspfad geschützt werden.

Erstellen Sie das Backup, speichern Sie es außerhalb des aktiven Konfigurationsgeräts und notieren Sie Zeitstempel und Version. Ein persistentes Layout für App-Daten sollte es ermöglichen, den Status zu sichern, ohne das Image selbst zu kopieren.

Dokumentieren Sie die Laufzeitdefinition ebenso sorgfältig wie die Daten

Ein perfektes Datenbank-Backup stellt Hardwarebeschleunigung, Ports, DNS, Geräte oder Berechtigungen nicht wieder her, wenn diese Einstellungen in der neu erstellten Containerdefinition fehlen. Behandeln Sie die Compose- oder Plattformkonfiguration als Teil des Wiederherstellungssatzes.

Der Betrieb von Containern unter einer stabilen Service-Identität hängt bei Upgrades und über mehrere Host-Dateisysteme hinweg von einer vorhersehbaren UID- und GID-Zuordnung ab.

Exportieren oder versionieren Sie die effektive Bereitstellungsdefinition ohne Geheimnisse. Dokumentieren Sie den Image-Digest und die Gerätezuordnungen, damit ein Rollback nicht vom Gedächtnis abhängt.

-15% OFF

ZimaBoard 2 – Mini-Heimserver für Ihre große Idee

Single board computer zimaboard2

Testen Sie den Wiederherstellungspfad, bevor Sie die alte Version entfernen

Die Bereinigung sollte erst erfolgen, nachdem die neue Version einen Neustart überstanden hat und das Backup gefunden und geöffnet werden kann. Wenn ein Rollback noch nie geprobt wurde, entziehen Sie sich durch das Löschen alter Images und Snapshots die kostengünstigsten Wiederherstellungsoptionen.

Ein getesteter Wiederherstellungspfad macht aus einem Backup eine tatsächlich erprobte Möglichkeit, einen nutzbaren Anwendungsstatus wiederherzustellen.

Überprüfen Sie Benutzer, Bibliotheken, Metadaten, eine Wiedergabe und einen Neustart. Bewahren Sie den Wiederherstellungssatz vor dem Upgrade auf, bis die neue Version ihre erwarteten Migrationen und die normalen Hintergrundprozesse abgeschlossen hat.