A edição manual do Compose ignorou as variáveis geridas pelo ZimaOS
Um novo utilizador do ZimaOS editou manualmente o ficheiro Compose do Jellyfin para alterar os caminhos de armazenamento. Após reiniciar, o Compose avisou que PGID, PUID, TZ e AppID não estavam definidos, e vários mapeamentos de dispositivos de hardware não funcionaram como esperado.
A resposta da comunidade explicou que o ZimaOS normalmente injeta esses valores através da sua camada de gestão de aplicações. Editar o YAML gerado fora desse fluxo pode deixar marcadores sem o ambiente que o ZimaOS esperava fornecer.
Altere o armazenamento através das definições da aplicação e dos volumes
O procedimento recomendado era abrir as definições da aplicação Jellyfin e alterar aí os mapeamentos de volumes, em vez de reescrever o ficheiro Compose. Desta forma, o ZimaOS pode manter os metadados da aplicação, as variáveis de ambiente e as entradas de dispositivos, aplicando simultaneamente os caminhos de armazenamento do anfitrião escolhidos.
Mais tarde, o autor confirmou que este método funcionou. Depois de selecionar os caminhos corretos da unidade secundária nas definições da aplicação, o Jellyfin funcionou corretamente sem o processo manual com o Compose.
A reinstalação restaura a configuração fornecida pela loja
Se a configuração gerada já tiver sido alterada extensivamente, a resposta propôs remover o Jellyfin do painel e reinstalá-lo a partir da App Store para restaurar os valores predefinidos originais. Os dados existentes da aplicação devem ser preservados através de mapeamentos corretos dos volumes do anfitrião antes da remoção; reinstalar um contentor não substitui a criação de uma cópia de segurança da sua configuração.
A reparação manual continua a ser possível apenas se todas as variáveis em falta e todos os caminhos de dispositivos necessários forem definidos corretamente. O tópico favoreceu a interface de definições do ZimaOS, por reduzir a possibilidade de perder valores geridos.
O mapeamento do disco no Proxmox foi uma complicação separada
O autor estava a executar o ZimaOS como máquina virtual no Proxmox, sobre Debian 13. Um disco passado com um comando qm set e um ponto de montagem desatualizado em /etc/fstab causaram problemas no modo de manutenção após o reinício. O ZimaOS também atribuiu ao dispositivo um nome diferente do esperado pelo utilizador.
Esse problema de virtualização era independente das variáveis do Compose em falta. Para obter um resultado funcional, foram necessários tanto um mapeamento estável do disco da máquina virtual como caminhos corretos para os volumes do Jellyfin na interface da aplicação do ZimaOS.
A questão posterior sobre NTP não fazia parte da resolução do Jellyfin
O tópico passou depois para a sincronização da hora, quando o Jellyfin já estava a funcionar. O comportamento do NTP no anfitrião e no convidado do Proxmox não causou os avisos do Compose, pelo que deve ser diagnosticado separadamente.
FAQ
Por que motivo PUID, PGID, TZ e AppID ficaram vazios?
Os avisos apareceram depois de as edições manuais terem ignorado os valores normalmente geridos pela camada de aplicações do ZimaOS.
Onde devem ser alterados os caminhos de armazenamento do Jellyfin?
A solução confirmada foi utilizar as definições da aplicação Jellyfin no ZimaOS e os respetivos controlos de volumes.
Os dispositivos de hardware em falta exigiam novos controladores?
O tópico não confirmou uma falha de controladores. Restaurar a configuração gerida da aplicação e os caminhos dos volumes resolveu a configuração do Jellyfin do autor.
