Solução da comunidade

Mover os ficheiros multimédia para outra unidade ZimaOS sem afetar o Jellyfin ou o Radarr: atualizar o caminho do volume Docker

A September 2025 support thread where a user moved movie folders from ZimaOS-HD to a new NVMe, Radarr saw the new storage but Jellyfin lost the files. Zima-Giorgio showed how to find the real host path and edit the app volume mapping through the GUI. The user immediately confirmed the GUI path picker solved the confusion.

Mover uma pasta de multimédia para outra unidade do ZimaOS não atualiza automaticamente todas as aplicações Docker que utilizavam o caminho antigo. Foi exatamente isso que aconteceu na fonte: os ficheiros de filmes foram movidos para um novo NVMe, o Radarr refletia a nova localização de armazenamento, mas o Jellyfin continuava a referenciar o antigo bind mount e já não conseguia encontrar o filme.

A solução é atualizar o caminho do volume no lado do anfitrião da aplicação, mantendo um caminho estável no lado do contentor, como /movies ou /media. O Zima-Giorgio mostrou tanto a deteção através da CLI como o seletor de pastas da interface gráfica, e o utilizador confirmou imediatamente que o método da interface gráfica resolveu o problema.

Definições de volumes do Radarr no ZimaOS, mostrando os caminhos do anfitrião à esquerda e os caminhos do contentor, como config, movies, downloads e extra-movies, à direita
A fonte já tinha vários mapeamentos de volumes Docker; mover a pasta física alterou o caminho do anfitrião à esquerda, não o conceito de caminho interno do Radarr.

O Docker Tem um Caminho do Anfitrião e um Caminho do Contentor

Um mapeamento tem, conceptualmente, o seguinte aspeto:

/caminho/real/no/ZimaOS  →  /caminho/dentro/da/aplicação

O lado esquerdo tem de apontar para o dispositivo de armazenamento e a pasta onde os ficheiros estão realmente guardados. O lado direito é o caminho que o Jellyfin/Radarr vê dentro do contentor.

Um Segundo Dispositivo de Armazenamento do ZimaOS Não Fica Automaticamente Dentro de /DATA

Barra lateral Ficheiros do ZimaOS, mostrando os dispositivos de armazenamento separados ZimaOS-HD, Zima-Media e Zima-Extra
O novo NVMe do utilizador da fonte apareceu como um espaço de armazenamento separado, pelo que escrever outro caminho /DATA/... criou uma pasta no armazenamento errado.

Essa foi a principal confusão. /DATA/extra-movies referia-se à área de dados do sistema/predefinida, não automaticamente à pasta no novo NVMe.

O Zima-Giorgio Sugeriu Verificar /media

Para identificar manualmente o caminho do anfitrião, o Giorgio sugeriu:

ls /media

Nessa altura, o armazenamento autónomo/montado aparecia em /media. O caminho exato pode variar consoante a gestão atual do armazenamento e a designação do dispositivo, por isso use o caminho apresentado pela interface atual em vez de tentar adivinhá-lo.

O Seletor de Pastas da Interface Gráfica Foi a Solução Confirmada pela Fonte

Definições do Jellyfin no ZimaOS, mostrando o ícone do seletor de pastas junto ao caminho do volume de multimédia no anfitrião
O Zima-Giorgio indicou o seletor do caminho do volume para que o utilizador pudesse selecionar a nova pasta de armazenamento sem introduzir manualmente o caminho de montagem.

O ZimaOS Atual Suporta Explicitamente a Atualização dos Caminhos dos Volumes Depois de Mover Dados

A documentação atual da IceWhale sobre os caminhos das aplicações indica agora que, quando uma unidade fica cheia, pode mover os dados de uma aplicação para outra unidade e atualizar o caminho nas definições da aplicação sem reinstalar a aplicação.

Utilize o fluxo de trabalho atual dos caminhos Docker do ZimaOS.

Mantenha o Caminho do Contentor Estável Sempre que Possível

Se o Jellyfin já utiliza internamente /Media, altere apenas o lado do anfitrião para a nova pasta física. Manter o caminho do contentor estável evita que a base de dados/biblioteca da aplicação passe a ver uma cadeia de caminho completamente diferente.

Atualize Todas as Aplicações Que Mapeiam a Pasta Movida

O Radarr, Sonarr, qBittorrent, Jellyfin, Plex e as ferramentas de importação podem ter os seus próprios mapeamentos de volumes. O facto de uma aplicação ver a nova pasta não atualiza as restantes.

Ficheiros do ZimaOS mostrando Books, Movies, Music e TV Shows no dispositivo de armazenamento Zima-Media
Depois da migração, cada contentor dependente deve mapear a pasta de multimédia real no novo dispositivo de armazenamento.

Verifique Antes de Remover a Pasta Antiga

Abra um filme no Jellyfin, deixe o Radarr analisar a pasta raiz, teste os caminhos de importação do qBittorrent, se aplicável, e confirme as permissões. Mantenha a pasta de origem antiga até todas as aplicações utilizarem corretamente o novo mapeamento no anfitrião.

Mover Multimédia É Diferente de Mover AppData

As pastas de filmes e séries são bibliotecas de conteúdos comuns. A AppData pode conter bases de dados SQLite/PostgreSQL, miniaturas, índices e o estado da aplicação, que podem exigir que a aplicação seja parada ou que seja utilizada a Migração de Dados do ZimaOS para garantir a consistência. Não trate todos os volumes como uma simples pasta de multimédia que pode ser arrastada e largada.

Volte a Verificar as Permissões no Novo Armazenamento

Um novo caminho correto no anfitrião pode continuar a falhar se a identidade do contentor conseguir ler a unidade antiga, mas não a nova. Depois de alterar o mapeamento, verifique se a aplicação consegue ler — e, quando necessário, escrever — na pasta de destino, sem conceder permissões de escrita globais desnecessárias.

FAQ sobre Caminhos de Multimédia Movidos

Porque é que o Jellyfin deixou de encontrar os ficheiros depois de os mover?

O bind mount Docker continuava a apontar para a pasta antiga no anfitrião.

O utilizador da fonte confirmou que o seletor da interface gráfica ajudou?

Sim. Respondeu imediatamente que não sabia que o seletor de caminhos existia e que este resolveu a sua dúvida.

Devo escrever /DATA para cada nova unidade de armazenamento?

Não. Utilize o caminho real no anfitrião apresentado ou selecionado pelo ZimaOS para esse dispositivo de armazenamento.