Solução da comunidade

Mova as fotografias do Immich do SSD do sistema ZimaOS para um HDD ou RAID: utilize a migração da biblioteca ou atualize o caminho do volume

An August 2025 thread where a new ZimaOS user installed Immich on a 128 GB system SSD but wanted phone photos stored on a separate 500 GB HDD. They tried the old Apps > User database migration and received a Something wrong error. A community reply linked a dedicated Immich storage guide. Current IceWhale documentation now explicitly documents Immich Library migration and a manual Gallery-copy/volume-path method.

Se o objetivo for “manter o Immich instalado no SSD, mas armazenar as fotografias no HDD/RAID”, não é necessário mover todas as categorias de aplicações. A documentação atual do ZimaOS inclui agora um fluxo de armazenamento específico para o Immich: utilize Migração de dados → Migração da biblioteca para bibliotecas de utilizadores, como Galeria/Multimédia, ou pare o Immich, copie a Galeria para o novo armazenamento, atualize o caminho do volume do anfitrião de immich-server e, em seguida, reinicie a aplicação.

O utilizador da fonte, em 2025, tentou utilizar o ecrã antigo Aplicações → Migração da base de dados do utilizador e recebeu um erro genérico “Algo está errado”. Esse ecrã antigo não deve ser utilizado como procedimento definitivo atual para o Immich, porque as ferramentas de armazenamento/migração do ZimaOS foram entretanto reformuladas.

Página histórica de migração de aplicações do ZimaOS mostrando as localizações dos dados da aplicação, da imagem da aplicação e da base de dados do utilizador no SSD do sistema
O utilizador da fonte concentrou-se na “Base de dados do utilizador”, mas o ZimaOS atual separa mais claramente a migração da biblioteca.
Ecrã histórico de migração do ZimaOS mostrando Algo está errado ao mover a base de dados do utilizador da unidade do sistema para sda1
A tentativa de migração antiga falhou, apesar de o HDD de destino estar vazio e de a biblioteca do Immich conter apenas uma imagem de teste.

Utilize a Migração Atual da Biblioteca para a Biblioteca de Fotografias do Utilizador

A documentação atual da IceWhale indica que Definições → Migração de dados pode mover categorias de bibliotecas, como Galeria, Documentos, Multimédia e Cópia de segurança, para outra localização de armazenamento.

Para uma biblioteca de fotografias do telemóvel no Immich que esteja localizada na Galeria do ZimaOS, este é o caminho gerido atual.

Consulte o guia atual de fotografias e armazenamento do Immich.

A Migração Manual Requer que o Immich Seja Parado Primeiro

O fluxo manual oficial atual é, em termos gerais:

  1. desative/pare o Immich;
  2. copie a pasta Gallery para o armazenamento de destino;
  3. edite o volume de immich-server para que o caminho do anfitrião aponte para a nova Galeria;
  4. reinicie o Immich;
  5. verifique as fotografias antigas e os novos carregamentos.

Não mova ficheiros por baixo de uma base de dados de fotografias em execução enquanto os carregamentos/indexação estiverem ativos.

Os Dados da Aplicação e a Biblioteca de Fotografias São Decisões de Armazenamento Diferentes

O estado da aplicação/base de dados do Immich e a biblioteca de fotografias do utilizador podem crescer a ritmos muito diferentes. É perfeitamente razoável manter o ambiente de execução/configuração leve da aplicação no SSD, enquanto coloca os grandes ficheiros de fotografias/vídeos num RAID ou HDD.

Não mova as imagens Docker nem os dados das aplicações de todas as aplicações apenas porque a biblioteca do Immich precisa de mais capacidade.

Proteja a Base de Dados do Immich Separadamente

Mover a biblioteca de ficheiros não substitui as cópias de segurança da base de dados. A base de dados do Immich contém o estado dos utilizadores, álbuns, metadados e registos de ficheiros. Mantenha uma cópia de segurança compatível da base de dados, juntamente com os ficheiros, se for importante garantir uma recuperação completa após um desastre.

Se o HDD Vier a Fazer Parte de um RAID, Planeie Já a Próxima Migração

O utilizador da fonte pretendia substituir o HDD de teste por uma matriz RAID. Um caminho de armazenamento estável de nível superior e o fluxo atual de Migração de dados do ZimaOS tornam essa futura migração mais fácil do que espalhar os volumes do Immich por várias pastas temporárias.

Verifique as Fotografias Existentes e um Novo Carregamento

Após a migração, abra várias imagens antigas e carregue uma fotografia nova a partir do telemóvel. Confirme que o novo ficheiro fica no HDD/RAID de destino, em vez de continuar silenciosamente a ocupar espaço no SSD do sistema.

Não Encha o Pequeno SSD do Sistema Durante os Testes

Um disco de sistema de 128 GB pode ficar cheio rapidamente quando se acumulam cópias de segurança do telemóvel, miniaturas e caches de aplicações. O ZimaOS atual permite aos utilizadores consultar as localizações dos dados das aplicações e migrar categorias para um armazenamento maior antes de a unidade do sistema atingir um nível crítico.

Perguntas Frequentes sobre a Localização do Armazenamento do Immich

Preciso de mover todos os dados das aplicações apenas para mover as fotografias do Immich?

Não. O ZimaOS atual disponibiliza migração específica da biblioteca e métodos de caminho dos volumes do Immich.

A migração antiga da base de dados do utilizador funcionou para o utilizador da fonte?

Não. A tentativa terminou com um erro genérico “Algo está errado”.

A aplicação pode permanecer no SSD enquanto as fotografias ficam no HDD/RAID?

Sim, desde que o caminho persistente da biblioteca de fotografias no anfitrião esteja associado ao armazenamento pretendido e as bases de dados/configurações tenham cópias de segurança adequadas.