Wenn Plex nicht mehr startet oder der App-Editor nach ZimaOS 1.7.0 beim Speichern „YAML-Platzhalter vor dem Speichern auflösen“ anzeigt, aktualisieren Sie ZimaOS auf 1.7.1 oder neuer, bevor Sie die App deinstallieren. 1.7.1 verbessert ausdrücklich die Kompatibilität beim Speichern von YAML und behebt ein Problem, bei dem die Deinstallation einer App deren Konfigurationsordner löschen konnte.
Der ursprüngliche Nutzer konnte das Problem durch eine erneute Installation von Plex beheben. IceWhale warnte jedoch sofort, dass die Deinstallation von Plex unter 1.7.0 standardmäßig die AppData löschte. Eine Neuinstallation ist daher kein guter erster Schritt, sofern die Plex-Konfiguration nicht bereits gesichert wurde.


ZimaOS aktualisieren, bevor Sie YAML manuell bearbeiten
Die offiziellen Versionshinweise zu ZimaOS 1.7.1 nennen eine verbesserte Kompatibilität beim Speichern von YAML sowie eine Fehlerbehebung für das Löschen von Konfigurationsordnern bei der App-Deinstallation.
Ursache der Platzhalterwarnung
Der IceWhale-Support wies den Nutzer an, <br> aus dem tips-Text im alten Plex-YAML zu entfernen. Es handelte sich um ein Kompatibilitätsproblem zwischen Paketierung und Parser, nicht um einen Fehler der Plex-Datenbank.
Prüfen, ob Plex tatsächlich läuft
docker ps | grep -i plex
docker logs --tail 200 plex
Ein funktionierender LinuxServer-Plex-Container sollte seinen internen Webdienst auf Port 32400 erreichen.
Plex-AppData vor der Neuinstallation sichern
Plex-Metadaten enthalten Bibliotheksdatenbanken, Wiedergabestatus, Poster und die Serveridentität. Ermitteln Sie das eingebundene Plex-Konfigurationsverzeichnis und sichern Sie es, bevor Sie den Container löschen oder neu erstellen.
Das aktuelle App-Store-Paket verwenden
Die aktuelle ZimaOS-Plex-App-Store-Seite führt die gepflegte Version 1.43.2.
Einbindung des Medienvolumes prüfen
Wenn Plex startet, die Bibliotheken jedoch leer sind, öffnen Sie die App-Einstellungen und bestätigen Sie, dass der Medienpfad des Hosts weiterhin dem von Plex verwendeten Containerpfad zugeordnet ist. Der aktuelle Plex-Einrichtungsleitfaden beschreibt den unterstützten Ablauf für die Speichereinbindung.
GPU-Geräte separat prüfen
Die Protokolle des ursprünglichen Falls zeigten, dass die Berechtigungen für /dev/dri/renderD128 und /dev/dri/card0 korrekt waren. Wenn die Wiedergabe funktioniert, die Transkodierung jedoch fehlschlägt, sollten Sie die GPU-Einbindung unabhängig vom YAML-Fehler untersuchen.
Der Plex-Hardwareleitfaden hilft bei diesem Prüfpfad.
Plex-Claim-Status prüfen
Die Protokolle des ursprünglichen Falls zeigten einen Lauf als bereits verknüpft und einen weiteren als nicht verknüpft. Wenn Plex geöffnet wird, aber den falschen Server- oder Kontostatus anzeigt, prüfen Sie, ob das persistente Konfigurationsvolume erhalten geblieben ist und ob Sie sich beim vorgesehenen Plex-Konto anmelden, bevor Sie Claim-Tokens neu erzeugen.
Container-Image nach der Aktualisierung von ZimaOS prüfen
docker inspect plex --format '{{.Config.Image}}'
Vergleichen Sie das laufende Image mit dem aktuellen App-Store-Paket. Eine erfolgreiche ZimaOS-Aktualisierung bedeutet nicht automatisch, dass sich ein altes, manuell festgelegtes Plex-Image geändert hat.
AppData wiederherstellen, bevor Sie Bibliotheken neu aufbauen
Wenn AppData vor der Deinstallation gesichert wurde, stellen Sie das Konfigurationsverzeichnis wieder her, bevor Sie davon ausgehen, dass Ihre Bibliotheksmetadaten verloren sind. Das erneute Hinzufügen von Terabytes an Medien zu einer neuen Plex-Datenbank kann lange Scans und Metadaten-Downloads auslösen, die sich vermeiden lassen, wenn die ursprüngliche Datenbank intakt ist.
FAQ
Sollte ich Plex deinstallieren, um den Fehler in 1.7.0 zu beheben?
Nicht, bevor Sie AppData gesichert haben. Unter 1.7.0 warnte IceWhale, dass die Deinstallation den Konfigurationsordner löschen könnte.
Was bedeutete der br-Platzhalterfehler?
Der App-Editor interpretierte Text im YAML-Feld tips falsch; der Support empfahl, den Eintrag <br> zu entfernen.
Behebt 1.7.1 diese Art von Problem?
Ja. Das Änderungsprotokoll enthält Verbesserungen bei der YAML-Speicherung sowie Fehlerbehebungen beim Löschen von App-Konfigurationen.
Warum läuft Plex, aber es werden keine Medien angezeigt?
Prüfen Sie die Zuordnung des Medienvolumes vom Host zum Container und starten Sie einen erneuten Scan der Plex-Bibliothek.
