Solución de la comunidad

Corrige la zona horaria de Jellyfin en ZimaOS: establece la variable de entorno TZ en una región IANA

A short November 2025 support thread where a new Jellyfin user in the United States saw TZ set to Europe/London. Zima-Jerry said to change the TZ environment variable to a valid region such as America/New_York. The original poster immediately confirmed the change worked.

La solución oficial al problema de origen es sencilla: Jellyfin se instaló con la variable de entorno del contenedor TZ=Europe/London, pero el usuario vivía en Estados Unidos. Zima-Jerry le indicó que reemplazara el valor por un identificador de zona horaria IANA adecuado, como America/New_York. El usuario lo cambió y confirmó de inmediato que funcionaba.

Este es un problema de configuración del contenedor, no una razón para reinstalar Jellyfin ni para cambiar el reloj del host de ZimaOS. Los ejemplos actuales de contenedores de Jellyfin siguen utilizando una variable de entorno TZ con valores regionales, como America/Los_Angeles.

Configuración de la aplicación Jellyfin en ZimaOS, con la variable de entorno TZ establecida en Europe/London
El problema de origen se ve directamente en la configuración de la aplicación: la TZ del contenedor de Jellyfin estaba establecida en la región incorrecta.

Cambiar la variable de entorno TZ

Abre la configuración de la aplicación Jellyfin en ZimaOS, busca la variable de entorno denominada TZ y reemplaza el valor por el identificador IANA correcto de región/ciudad.

Algunos ejemplos son:

  • America/New_York;
  • America/Chicago;
  • America/Denver;
  • America/Los_Angeles;
  • Europe/London;
  • Asia/Tokyo.

Usa nombres de región/ciudad, no un desplazamiento UTC fijo

Una zona horaria IANA entiende las transiciones al horario de verano y los cambios históricos de las reglas. Un valor fijo como UTC-5 puede ser incorrecto durante parte del año en lugares que aplican el horario de verano.

Guarda la configuración de la aplicación y permite que el contenedor se reinicie

Las variables de entorno se inyectan cuando se inicia el contenedor. Después de cambiar TZ, guarda la configuración de la aplicación y permite que Jellyfin se reinicie o se vuelva a crear según lo requiera ZimaOS.

Después, confirma la hora en los registros de Jellyfin, las tareas programadas y cualquier interfaz cuyo contenido dependa de la fecha.

No cambies el reloj del sistema de ZimaOS solo para corregir un contenedor

Si el panel de ZimaOS ya muestra la hora correcta, pero Jellyfin no, cambia primero la zona horaria del contenedor de Jellyfin. La configuración de NTP y hora del host, y la hora mostrada por el contenedor, son capas independientes.

Las asignaciones de puertos personalizadas del problema de origen no formaban parte de la solución de TZ

Configuración de la aplicación Jellyfin en ZimaOS, con asignaciones de puertos del host al contenedor, incluida la asignación de 8097 a 8096
El problema de origen también tenía puertos personalizados, pero Zima-Jerry no identificó esas asignaciones como la causa de la zona horaria incorrecta.

Las asignaciones de dispositivos GPU son un problema independiente de Jellyfin

Configuración de Jellyfin en ZimaOS, con asignaciones de GPU y dispositivos de vídeo, incluida /dev/dri
Los dispositivos de transcodificación por hardware no afectan a la variable de entorno TZ; soluciónalos por separado.

Los ejemplos actuales de Docker para Jellyfin utilizan el mismo patrón de TZ

La documentación actual de contenedores de Jellyfin incluye configuraciones de entorno como:

TZ=America/Los_Angeles

Consulta el patrón actual de entorno de contenedor de Jellyfin.

Por qué la zona horaria es importante más allá de la visualización del reloj

Jellyfin utiliza la información horaria para los registros, el mantenimiento programado, las tareas de la biblioteca, el historial de actividad y otros comportamientos que dependen de la fecha. Por lo tanto, un valor incorrecto de TZ puede hacer que un servidor en buen estado resulte confuso, aunque la reproducción multimedia funcione correctamente.

Después de cambiar la variable, verifica al menos la marca de tiempo de una tarea programada o una entrada reciente del registro para asegurarte de que el contenedor, y no solo el navegador, ve ahora la zona prevista.

Preguntas frecuentes sobre la zona horaria de Jellyfin

¿Cambiar TZ solucionó el problema del usuario de origen?

Sí. El usuario confirmó explícitamente que funcionaba.

¿El valor debería ser EST o PST?

Es preferible utilizar una región IANA, como America/New_York o America/Los_Angeles, para que las reglas del horario de verano se gestionen correctamente.

¿Es necesario cambiar la configuración de puertos o GPU de Jellyfin para solucionar la zona horaria?

No. Esas configuraciones son independientes de la variable de entorno TZ.