La correction d’origine est simple et officielle : Jellyfin avait été installé avec la variable d’environnement du conteneur TZ=Europe/London, alors que l’utilisateur vivait aux États-Unis. Zima-Jerry lui a conseillé de remplacer cette valeur par un identifiant de fuseau horaire IANA approprié, tel que America/New_York. L’utilisateur l’a modifiée et a immédiatement confirmé que cela fonctionnait.
Il s’agit d’un problème de configuration du conteneur, et non d’une raison de réinstaller Jellyfin ou de modifier l’horloge de l’hôte ZimaOS. Les exemples actuels de conteneurs Jellyfin continuent d’utiliser une variable d’environnement TZ avec des valeurs au format région/ville telles que America/Los_Angeles.
Modifier la variable d’environnement TZ
Ouvrez les paramètres de l’application Jellyfin dans ZimaOS, recherchez la variable d’environnement nommée TZ, puis remplacez sa valeur par l’identifiant IANA correct au format région/ville.
Exemples :
-
America/New_York; -
America/Chicago; -
America/Denver; -
America/Los_Angeles; -
Europe/London; -
Asia/Tokyo.
Utiliser des noms au format région/ville, et non un décalage UTC fixe
Un fuseau horaire IANA gère les changements liés à l’heure d’été ainsi que les modifications historiques des règles. Une valeur fixe telle que UTC-5 peut donc être incorrecte pendant une partie de l’année dans les régions qui appliquent l’heure d’été.
Enregistrer les paramètres de l’application et laisser le conteneur redémarrer
Les variables d’environnement sont injectées au démarrage du conteneur. Après avoir modifié TZ, enregistrez les paramètres de l’application et laissez Jellyfin redémarrer ou être recréé comme l’exige ZimaOS.
Vérifiez ensuite l’heure dans les journaux Jellyfin, les tâches planifiées et toute interface dépendant des dates.
Ne modifiez pas l’horloge système de ZimaOS pour corriger un seul conteneur
Si le tableau de bord ZimaOS affiche déjà l’heure correcte, mais que Jellyfin ne l’affiche pas, modifiez d’abord le fuseau horaire du conteneur Jellyfin. Les paramètres NTP et horaires de l’hôte, ainsi que le fuseau horaire affiché par le conteneur, sont des couches distinctes.
Les mappages de ports personnalisés de la source ne faisaient pas partie de la correction de TZ
Les mappages de périphériques GPU constituent un problème Jellyfin distinct
Les exemples Docker actuels de Jellyfin utilisent le même modèle TZ
La documentation actuelle de Jellyfin pour les conteneurs comprend des paramètres d’environnement tels que :
TZ=America/Los_AngelesConsultez le modèle actuel d’environnement des conteneurs Jellyfin.
Pourquoi le fuseau horaire est important au-delà de l’affichage de l’heure
Jellyfin utilise les informations horaires pour les journaux, la maintenance planifiée, les tâches de bibliothèque, l’historique d’activité et d’autres fonctions dépendant des dates. Une valeur TZ incorrecte peut donc rendre un serveur fonctionnel difficile à comprendre, même lorsque la lecture des contenus multimédias fonctionne.
Après avoir modifié la variable, vérifiez au moins l’horodatage d’une tâche planifiée ou d’une entrée récente du journal afin de vous assurer que le conteneur — et pas seulement le navigateur — utilise désormais le fuseau souhaité.
Foire aux questions sur le fuseau horaire de Jellyfin
La modification de TZ a-t-elle résolu le problème de l’utilisateur à l’origine de la demande ?
Oui. L’utilisateur a explicitement répondu que cela fonctionnait.
La valeur doit-elle être EST ou PST ?
Privilégiez une région IANA telle que America/New_York ou America/Los_Angeles afin que les règles relatives à l’heure d’été soient correctement appliquées.
Les paramètres de ports ou de GPU de Jellyfin doivent-ils être modifiés pour corriger le fuseau horaire ?
Non. Ces paramètres sont indépendants de la variable d’environnement TZ.
