Soluzione della community

Correggi il fuso orario di Jellyfin su ZimaOS: imposta la variabile d’ambiente TZ su una regione 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 soluzione ufficiale al problema era semplice: Jellyfin era stato installato con la variabile d’ambiente del container TZ=Europe/London, ma l’utente viveva negli Stati Uniti. Zima-Jerry gli ha indicato di sostituire il valore con un identificatore di fuso orario IANA appropriato, come America/New_York. L’utente lo ha modificato e ha confermato immediatamente che il problema era risolto.

Si tratta di un problema di configurazione del container, non di un motivo per reinstallare Jellyfin o modificare l’orologio dell’host ZimaOS. Gli esempi attuali per i container Jellyfin continuano a utilizzare una variabile d’ambiente TZ con valori nel formato regione/città, come America/Los_Angeles.

Impostazioni dell’app Jellyfin in ZimaOS con la variabile d’ambiente TZ impostata su Europe/London
Il problema originale è visibile direttamente nelle impostazioni dell’app: il fuso orario TZ del container Jellyfin era impostato sulla regione sbagliata.

Modificare la variabile d’ambiente TZ

Apri le impostazioni dell’app Jellyfin in ZimaOS, individua la variabile d’ambiente denominata TZ e sostituisci il valore con l’identificatore IANA corretto nel formato regione/città.

Gli esempi includono:

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

Utilizzare i nomi Regione/Città, non un offset UTC fisso

Un fuso orario IANA tiene conto dei passaggi all’ora legale e dei cambiamenti storici delle regole. Un valore fisso come UTC-5 può essere errato in parte dell’anno nelle località che adottano l’ora legale.

Salvare le impostazioni dell’app e consentire il riavvio del container

Le variabili d’ambiente vengono iniettate all’avvio del container. Dopo aver modificato TZ, salva le impostazioni dell’app e consenti a Jellyfin di riavviarsi o ricrearsi come richiesto da ZimaOS.

Verifica quindi l’ora nei log di Jellyfin, nelle attività pianificate e in qualsiasi interfaccia sensibile alla data.

Non modificare l’orologio di sistema di ZimaOS solo per correggere un singolo container

Se il pannello di controllo di ZimaOS mostra già l’ora corretta ma Jellyfin no, modifica prima il fuso orario del container di Jellyfin. Le impostazioni NTP e dell’ora dell’host sono livelli distinti rispetto alla visualizzazione dell’ora nel container.

Le mappature personalizzate delle porte della configurazione originale non facevano parte della correzione di TZ

Impostazioni dell’app Jellyfin in ZimaOS con mappature delle porte host-container, inclusa la mappatura da 8097 a 8096
La configurazione originale includeva anche porte personalizzate, ma Zima-Jerry non ha indicato tali mappature come causa del fuso orario errato.

Le mappature dei dispositivi GPU sono un problema separato di Jellyfin

Impostazioni di Jellyfin in ZimaOS con mappature della GPU e dei dispositivi video, inclusa /dev/dri
I dispositivi per la transcodifica hardware non influiscono sulla variabile d’ambiente TZ; risolvi i relativi problemi separatamente.

Gli esempi Docker attuali di Jellyfin utilizzano lo stesso schema TZ

La documentazione attuale di Jellyfin per i container include impostazioni d’ambiente come:

TZ=America/Los_Angeles

Consulta lo schema attuale dell’ambiente del container Jellyfin.

Perché il fuso orario è importante oltre alla visualizzazione dell’ora

Jellyfin utilizza le informazioni temporali per i log, la manutenzione pianificata, le attività della libreria, la cronologia delle attività e altri comportamenti sensibili alla data. Un valore TZ errato può quindi rendere confuso il comportamento di un server funzionante, anche quando la riproduzione dei contenuti multimediali funziona correttamente.

Dopo aver modificato la variabile, verifica almeno l’orario di un’attività pianificata o di una voce recente nei log, così potrai assicurarti che sia il container, e non solo il browser, a utilizzare il fuso orario desiderato.

Domande frequenti sul fuso orario di Jellyfin

La modifica di TZ ha risolto il problema dell’utente originale?

Sì. L’utente ha risposto esplicitamente che il problema era stato risolto.

Il valore dovrebbe essere EST o PST?

Preferisci una regione IANA, come America/New_York o America/Los_Angeles, così le regole dell’ora legale vengono gestite correttamente.

È necessario modificare le impostazioni delle porte o della GPU di Jellyfin per correggere il fuso orario?

No. Queste impostazioni sono separate dalla variabile d’ambiente TZ.