Restaurez Jellyfin après l’échec d’une mise à jour du conteneur en protégeant les données persistantes avant de remplacer, restaurer ou recréer l’environnement d’exécution.
Une mise à jour échouée peut être due à un problème d’image, à une variable d’environnement modifiée, à une association de périphérique perdue, à une erreur de volume ou à un problème de migration de l’application. Capturez l’état en échec et identifiez la couche qui a changé. La récupération est plus sûre si le répertoire de configuration reste intact jusqu’à ce que vous sachiez si le problème concerne l’environnement d’exécution ou les données.
Figez l’état en échec avant tout nouveau téléchargement
Désactivez les mises à jour automatiques et les boucles de redémarrage afin que chaque nouvelle tentative ne modifie pas les journaux, les balises d’image ou l’état de l’application. Enregistrez la définition effective du conteneur ainsi que la première erreur fatale.
Il est beaucoup plus facile d’annuler une mise à niveau échouée lorsqu’une sauvegarde Jellyfin préalable à la modification existe déjà ; sans elle, une défaillance de l’environnement d’exécution peut se transformer en problème de récupération de l’état.
Notez le condensat de l’image, les points de montage, les périphériques, l’environnement, le mode réseau et les journaux récents. N’exécutez aucune commande de nettoyage ou de suppression tant que l’ensemble nécessaire à la récupération n’a pas été identifié.
Protégez la configuration et la base de données avant toute recréation
L’image remplaçable doit être séparée de la base de données Jellyfin persistante, de la configuration, des métadonnées et des plugins. Créez une copie en lecture seule ou un instantané avant qu’un binaire plus ancien ou plus récent n’ouvre à nouveau ces données.
Les sauvegardes de configuration Jellyfin protègent les comptes utilisateurs, les paramètres des bibliothèques, l’historique de visionnage et les métadonnées, séparément de la bibliothèque multimédia elle-même.
Copiez le chemin persistant vers un second emplacement et préservez les droits de propriété. La limite de persistance du conteneur est correcte uniquement si un environnement d’exécution propre peut se reconnecter sans créer un serveur vide.
Restaurez la plus petite couche en échec
Si l’ancienne image fonctionne avec le même état et les mêmes points de montage, le problème vient du processus de mise à jour plutôt que de la bibliothèque. Si les deux versions échouent, cessez de changer d’image et examinez séparément les données ou les permissions.
Un échec de démarrage de Jellyfin lié à une version spécifique doit être distingué des modifications générales du stockage et du réseau.
Testez une restauration vers une version antérieure ou une image connue comme fonctionnelle avec une copie de l’ensemble des données d’état. Évitez de forcer des migrations répétées sur l’unique copie de la base de données.
Validez l’identité, les bibliothèques et une lecture avant de reprendre l’automatisation
Un conteneur qui atteint l’état « en cours d’exécution » n’est pas entièrement restauré tant que les utilisateurs, les bibliothèques, l’état de visionnage, les chemins et le comportement de lecture attendus ne sont pas rétablis. Les analyses et l’automatisation associée peuvent générer de nouvelles écritures ; laissez-les donc en pause pendant la validation.
Un test de restauration correct vérifie le comportement de l’application après la récupération, au lieu de considérer une extraction réussie des fichiers comme une preuve suffisante.
Confirmez l’identité du serveur, parcourez une bibliothèque, effectuez une lecture directe, un transcodage si nécessaire et un redémarrage. Ensuite seulement, réactivez les analyses planifiées et les mises à jour automatiques.
Assistance et conseils
Plus à lire

Faut-il sauvegarder Jellyfin à chaud ou arrêter le service au préalable ?
Privilégiez les sauvegardes lorsque le service est arrêté pour plus de simplicité ; n’utilisez des instantanés à chaud que lorsque l’état de l’application est...

Pourquoi Jellyfin chauffe-t-il ou est-il bruyant lorsque personne ne regarde de contenu en streaming ?
La chaleur au repos indique généralement une activité en arrière-plan ou une charge de travail d’hébergement partagé. Identifiez donc le processus actif et la...

Quand faut-il reconstruire Jellyfin plutôt que le réparer ?
Choisissez la reconstruction plutôt que la réparation lorsque la dérive de l’environnement d’exécution est à l’origine du problème et que l’état persistant est sauvegardé...

