Solução da comunidade

Corrigir o fuso horário do Jellyfin no ZimaOS: definir a variável de ambiente TZ para uma região 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.

A correção original é simples e oficial: o Jellyfin foi instalado com a variável de ambiente do contentor TZ=Europe/London, mas o utilizador vivia nos Estados Unidos. O Zima-Jerry indicou-lhe que substituísse o valor por um identificador de fuso horário IANA adequado, como America/New_York. O utilizador alterou-o e confirmou imediatamente que funcionava.

Este é um problema de configuração do contentor, não uma razão para reinstalar o Jellyfin ou alterar o relógio do anfitrião ZimaOS. Os exemplos atuais de contentores Jellyfin continuam a utilizar uma variável de ambiente TZ com valores no formato região, como America/Los_Angeles.

Definições da aplicação Jellyfin no ZimaOS, mostrando a variável de ambiente TZ definida como Europe/London
O problema original é diretamente visível nas definições da aplicação: o TZ do contentor do Jellyfin estava definido para a região errada.

Alterar a variável de ambiente TZ

Abra as definições da aplicação Jellyfin no ZimaOS, localize a variável de ambiente com o nome TZ e substitua o valor pelo identificador IANA correto de região/cidade.

Exemplos:

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

Utilizar nomes de região/cidade, não uma diferença fixa em relação ao UTC

Um fuso horário IANA compreende as mudanças para a hora de verão e as alterações históricas das regras. Um valor fixo como UTC-5 pode estar errado durante parte do ano em locais que adotam a hora de verão.

Guardar as definições da aplicação e deixar o contentor reiniciar

As variáveis de ambiente são injetadas quando o contentor é iniciado. Depois de alterar o TZ, guarde as definições da aplicação e permita que o Jellyfin reinicie/seja recriado conforme necessário no ZimaOS.

Em seguida, confirme a hora nos registos do Jellyfin, nas tarefas agendadas e em qualquer interface que dependa da data.

Não altere o relógio do sistema ZimaOS apenas para corrigir um contentor

Se o painel do ZimaOS já mostrar a hora correta, mas o Jellyfin não, altere primeiro o fuso horário do contentor do Jellyfin. As definições de NTP/hora do anfitrião e a apresentação da hora no contentor são camadas distintas.

Os mapeamentos de portas personalizados do caso original não faziam parte da correção do TZ

Definições da aplicação Jellyfin no ZimaOS, mostrando mapeamentos de portas anfitrião-contentor, incluindo 8097 para 8096
O caso original também tinha portas personalizadas, mas o Zima-Jerry não identificou esses mapeamentos como a causa do fuso horário incorreto.

Os mapeamentos de dispositivos GPU são um problema separado do Jellyfin

Definições do Jellyfin no ZimaOS, mostrando mapeamentos de dispositivos GPU e vídeo, incluindo /dev/dri
Os dispositivos de transcodificação por hardware não afetam a variável de ambiente TZ; resolva-os separadamente.

Os exemplos atuais de Docker do Jellyfin utilizam o mesmo padrão TZ

A documentação atual de contentores do Jellyfin inclui definições de ambiente como:

TZ=America/Los_Angeles

Consulte o padrão atual de ambiente de contentor do Jellyfin.

Porque é que o fuso horário é importante para além da apresentação do relógio

O Jellyfin utiliza informações de hora nos registos, na manutenção agendada, nas tarefas da biblioteca, no histórico de atividade e noutros comportamentos dependentes da data. Um valor TZ incorreto pode, por isso, fazer com que um servidor saudável pareça confuso, mesmo quando a reprodução multimédia funciona.

Depois de alterar a variável, verifique pelo menos um carimbo de data/hora de uma tarefa agendada ou uma entrada recente do registo, para confirmar que é o contentor — e não apenas o navegador — que vê agora o fuso pretendido.

Perguntas frequentes sobre o fuso horário do Jellyfin

A alteração do TZ resolveu o problema do utilizador original?

Sim. O utilizador respondeu explicitamente que funcionou.

O valor deve ser EST ou PST?

Prefira uma região IANA, como America/New_York ou America/Los_Angeles, para que as regras da hora de verão sejam aplicadas corretamente.

É necessário alterar as definições de portas ou da GPU do Jellyfin para corrigir o fuso horário?

Não. Essas definições são independentes da variável de ambiente TZ.