Comment savoir si Jellyfin utilise le fichier de configuration attendu

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Oui, vous pouvez vérifier si Jellyfin utilise le répertoire de configuration prévu sans vous fier à la présence d’un fichier sur l’hôte. La méthode fiable consiste à déterminer l’ordre de priorité des chemins de Jellyfin, à examiner les paramètres du processus ou du conteneur en cours d’exécution, puis à confirmer le chemin actif dans les journaux de démarrage avant de modifier un fichier de configuration.

C’est important après être passé d’une installation par paquet à Docker, avoir cloné un fichier Compose ou restauré un ancien serveur, car plusieurs copies de network.xml, system.xml ou logging.json peuvent exister alors qu’un seul répertoire est actif. Ne modifiez pas chaque copie jusqu’à ce que le problème disparaisse. Identifiez d’abord le répertoire de configuration actif, effectuez une modification réversible et vérifiez que Jellyfin indique le même chemin après un redémarrage.

Déterminer d’abord l’ordre de priorité des chemins de configuration

Commencez par déterminer comment Jellyfin a été lancé. L’option de ligne de commande --configdir est prioritaire sur la variable d’environnement JELLYFIN_CONFIG_DIR, tandis que les chemins par défaut de la plateforme ne sont utilisés qu’en l’absence de paramètres prioritaires.

La hiérarchie officielle des chemins de configuration documente l’ordre de priorité des chemins des répertoires de données, de configuration, de cache et Web. Comparez cet ordre à votre unité de service, à l’environnement du conteneur ou à la commande de démarrage avant de supposer qu’un dossier familier de l’hôte est actif.

Si un paramètre prioritaire pointe vers un emplacement inattendu, arrêtez-vous là : le fichier concurrent trouvé sur le disque ne prouve pas que Jellyfin le lit. Corrigez la configuration de lancement ou conservez délibérément le chemin actif et consignez-le.

Inspecter le conteneur en cours d’exécution ou la définition du service

Avec Docker, inspectez le conteneur en cours d’exécution plutôt que le seul fichier Compose enregistré sur le disque. L’objet en cours d’exécution indique quelles variables d’environnement et quels montages ont réellement été appliqués lors de la création du conteneur.

La définition en direct du conteneur renvoyée par Docker fournit des informations de bas niveau sur un conteneur en cours d’exécution. Elles permettent de comparer les valeurs d’environnement et les destinations des montages avec les chemins Jellyfin attendus. Un fichier Compose modifié après la création du conteneur peut ne pas correspondre à l’exécution actuelle.

Pour un service natif, examinez l’unité systemd et tout fichier d’environnement qu’elle charge. Si la définition d’exécution et vos notes ne concordent pas, fiez-vous à l’exécution, puis décidez s’il faut recréer le service avec le chemin prévu.

Confirmer le chemin à partir des éléments de démarrage de Jellyfin

Après avoir noté le chemin attendu, redémarrez une fois, puis lisez les premières lignes du journal de démarrage de Jellyfin. Repérez les chemins configurés pour les données, le cache ou le stockage, puis comparez-les à ceux du processus ou du conteneur que vous venez d’examiner.

Ne considérez pas une connexion réussie à l’interface web comme la preuve que le bon répertoire de configuration est actif. Jellyfin peut démarrer normalement avec un chemin de configuration neuf ou ancien tout en affichant une interface fonctionnelle, alors que les paramètres utilisateur, le réseau, les plug-ins ou les tâches planifiées proviennent d’un état incorrect.

Lors du transfert d’un serveur multimédia d’une méthode de déploiement à une autre, les mêmes règles de gestion des chemins s’appliquent à l’ensemble de la pile. Pour commencer, consultez le guide de configuration multimédia domestique avec Jellyfin, qui traite le chemin de l’application, celui des médias et celui de l’accès comme des éléments distincts de la configuration.

Utilisez une modification de configuration sans risque comme critère de distinction

Si deux répertoires candidats semblent toujours plausibles, arrêtez Jellyfin avant de modifier un fichier de configuration XML du serveur. Choisissez un paramètre réversible dont l’effet est évident et modifiez-le uniquement dans le répertoire supposé actif. Évitez les données utilisateur, les chemins des bibliothèques ou tout élément susceptible de déclencher une réanalyse importante pour simplement vérifier quel fichier est sélectionné.

Démarrez Jellyfin et vérifiez si le paramètre choisi apparaît. Si c’est le cas, arrêtez de nouveau le service, annulez la modification, puis redémarrez une fois de plus pour confirmer sa persistance. Si ce n’est pas le cas, le fichier n’est pas actif ou une source de configuration prioritaire le remplace.

Ce test A/B hors ligne contrôlé est plus fiable qu’une comparaison des horodatages, car les outils de sauvegarde, les mises à niveau de paquets et les éditeurs peuvent tous modifier des fichiers inactifs. Jellyfin indique que ces options de configuration sont généralement statiques et doivent être définies avant le démarrage du serveur. Évitez donc les modifications à chaud, sauf si le comportement d’un paramètre particulier est explicitement documenté.

Arrêtez-vous dès que le chemin actif reste inchangé après un redémarrage

Le diagnostic est confirmé lorsque la définition d’exécution, les éléments du journal de démarrage et une modification de configuration réversible indiquent tous le même répertoire après un redémarrage. Consignez ce chemin dans vos notes de déploiement et incluez-le dans le périmètre des sauvegardes.

Si le chemin actif change après la recréation du conteneur, examinez la façon dont le volume et les variables d’environnement sont générés au lieu de modifier sans cesse les fichiers de Jellyfin. Le problème vient alors de l’état du déploiement, et non de l’analyseur de configuration de Jellyfin.

Ne faites remonter le problème que si le chemin d’exécution est sans équivoque, mais que Jellyfin ignore systématiquement un paramètre valide dans le fichier actif. Conservez le journal de démarrage et la version exacte avant de demander de l’aide, afin de distinguer le problème d’un fichier en double.

Assistance et conseils

À lire aussi

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.