Solução da comunidade

Mover o armazenamento de fotografias do Immich para um NAS ou para um disco maior no ZimaOS

A March–April 2025 Immich storage thread where an IceWhale reply pointed users to Docker path mapping and a community member documented the exact host-side volume changes needed to move database, model cache, uploads, and selected media paths to larger storage.

O Immich pode consumir uma grande quantidade de armazenamento, pelo que deixar os carregamentos, a base de dados e a cache de aprendizagem automática no disco do sistema ZimaOS raramente é o ideal para uma biblioteca de fotografias em crescimento.

Este tópico de 2025 documenta uma forma manual de mover o Immich para outra localização de armazenamento do ZimaOS, editando os mapeamentos de volumes no anfitrião. O ZimaOS atual também disponibiliza controlos mais diretos para a localização do armazenamento e a migração, pelo que as capturas de ecrã manuais devem ser vistas sobretudo como uma explicação de como os caminhos dos contentores se relacionam.

Abra as definições do Immich antes de alterar os volumes

Menu da aplicação Immich no ZimaOS com a opção Definições realçada antes de alterar os volumes de armazenamento
O procedimento da comunidade começava por abrir as definições da aplicação Immich instalada, em vez de mover pastas às cegas em Ficheiros.

Mova o caminho do anfitrião da base de dados, não o caminho do contentor

Mapeamento do volume da base de dados do Immich com um caminho do anfitrião em /media/Main e o caminho do contentor PostgreSQL inalterado
A configuração utilizada pela comunidade alterava o lado do ZimaOS no mapeamento da base de dados, mantendo intacto o destino do contentor PostgreSQL.

Esta distinção entre anfitrião e contentor é fundamental. A aplicação espera caminhos específicos dentro dos seus contentores; alterar ambos os lados sem compreender a arquitetura pode impedir o arranque ou fazer com que os dados existentes pareçam estar em falta.

A cache de aprendizagem automática também pode ficar num armazenamento maior

Mapeamento do volume de aprendizagem automática do Immich com a cache de modelos armazenada num caminho /media maior no ZimaOS
O exemplo da comunidade movia a pasta da cache de modelos no lado do anfitrião, mantendo o destino de cache esperado pelo contentor.

O separador immich-server requer mais cuidado

Mapeamentos de volumes do servidor Immich que mostram o caminho de carregamento e as pastas multimédia selecionadas redirecionados para armazenamento em /media
O autor da publicação salientou que alguns mapeamentos do immich-server devem ser alterados, enquanto outros têm de permanecer exatamente como esperado pela aplicação.

A publicação original foi testada pela comunidade, não sendo uma garantia da IceWhale para todas as versões do Immich. A arquitetura do Immich mudou significativamente ao longo do tempo, por isso não recrie esta tabela de volumes de 2025 numa versão mais recente sem comparar a definição atual da aplicação.

O ZimaOS atual disponibiliza um procedimento de armazenamento mais direto

As instruções atuais do Immich no ZimaOS permitem aos utilizadores alterar as localizações dos ficheiros de armazenamento e descrevem como mover os dados do Immich para outro disco através da Migração de dados ou de uma cópia manual controlada.

Numa instalação atual, comece pelos controlos atuais de armazenamento e migração do Immich antes de recriar mapeamentos de volumes a partir de uma captura de ecrã de 2025.

Se mover ficheiros manualmente, pare primeiro o Immich

As orientações atuais do ZimaOS indicam que deve desativar o Immich antes de copiar manualmente os dados da Galeria, atualizar depois o caminho correspondente no anfitrião e reiniciar a aplicação. Interromper as gravações durante a transferência reduz o risco de copiar uma biblioteca de fotografias inconsistente.

Perguntas frequentes sobre o armazenamento do Immich no ZimaOS

O Immich pode armazenar fotografias num disco maior em vez do ZimaOS-HD?

Sim. Tanto o exemplo da comunidade de 2025 como o procedimento atual do Immich no ZimaOS permitem utilizar outra localização de armazenamento.

Devo alterar o caminho do PostgreSQL no lado do contentor?

Não no procedimento original. O caminho de armazenamento no anfitrião foi alterado, enquanto o caminho do contentor da aplicação permaneceu no local PostgreSQL esperado.

Tenho de seguir exatamente os quatro separadores de 2025?

Não. Considere-os exemplos históricos da disposição dos contentores. Compare-os com o pacote atual do Immich antes de alterar qualquer coisa.

Existe agora uma opção de migração integrada?

As orientações atuais do Immich no ZimaOS descrevem tanto a Migração de dados como uma transferência manual controlada dos dados do Immich.