Como migrar os dados do Immich sem perder utilizadores, histórico ou definições

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Migre o Immich como uma migração do estado da aplicação, não como uma simples cópia de pastas: preserve a base de dados, a árvore de conteúdos multimédia, a configuração, os segredos e os caminhos que os interligam.

Uma migração pode parecer bem-sucedida porque todos os ficheiros JPEG estão no novo disco, embora faltem contas, álbuns, pessoas, partilhas, favoritos ou relações históricas. Defina primeiro um ponto de reversão, capture um estado de origem consistente, copie-o sem alterar os identificadores, restaure-o num destino isolado e só faça a transição depois de os fluxos de trabalho domésticos estarem a funcionar como antes.

Faça o inventário dos dados que têm de ser migrados em conjunto

Faça o inventário da base de dados PostgreSQL, dos conteúdos multimédia carregados, dos dados gerados que pretende manter, das definições das bibliotecas externas, da configuração do Compose ou da aplicação, dos valores do ambiente, dos segredos, dos nomes da rede e dos mapeamentos de armazenamento atuais. Assinale qual é o elemento de referência e quais podem ser regenerados após a recuperação.

Uma discussão de 2026 sobre a preservação dos utilizadores do Immich durante uma migração reforça o princípio fundamental: o estado dos utilizadores e da biblioteca está associado à base de dados e aos caminhos montados, não à imagem do contentor. Trate os comandos da comunidade como exemplos e adapte-os à versão exata implementada.

Antes da migração, anote um pequeno conjunto para verificação: dois utilizadores, vários álbuns, favoritos, itens partilhados, uma pessoa ou um resultado de pesquisa, ficheiros antigos e recentes e um caminho de biblioteca externa, caso seja utilizado. Esses registos conhecidos permitirão validar a migração de forma muito mais rigorosa do que comparar apenas o tamanho total dos ficheiros.

Crie um ponto de recuperação consistente antes de copiar

Suspenda os novos carregamentos ou agende uma janela de manutenção para impedir que a origem sofra alterações durante a captura do estado da migração. Faça uma cópia de segurança nativa da base de dados e proteja os conteúdos multimédia de origem e a configuração. Após a captura, mantenha a instância original intacta até o destino ter passado pela verificação.

O guia de recuperação do ZimaSpace sobre a restauração conjunta dos componentes de uma biblioteca de fotografias explica por que motivo os originais, o estado do catálogo e a configuração que define os caminhos têm de corresponder a um ponto de recuperação compatível. Esse é também o princípio que uma migração deve seguir.

Não use o diretório da base de dados de produção em funcionamento como destino de uma cópia de ficheiros normal enquanto está a sofrer alterações. Se o tempo de inatividade tiver de ser curto, use uma exportação da base de dados e um método de armazenamento cuja ordem de captura compreenda. A capacidade de recuperação de uma migração depende do ponto que consegue restaurar, não do número de ficheiros copiados.

Copie os conteúdos multimédia preservando os caminhos e as permissões

Copie a árvore de conteúdos multimédia para o destino sem reorganizar as pastas durante a migração. Preserve a propriedade, as permissões, os carimbos de data/hora e quaisquer funcionalidades do sistema de ficheiros de que a sua implementação dependa. Se o caminho visível no contentor tiver de permanecer igual, altere a origem da montagem no anfitrião, mantendo estável o mapeamento dentro do contentor.

O fluxo de trabalho de migração com rsync atual destaca o modo de arquivo, as simulações, as transferências retomáveis e os perigos das opções de espelhamento destrutivas. Execute uma comparação simulada antes de eliminar qualquer ficheiro e verifique o destino, em vez de presumir que um comando concluído corresponde a uma migração completa da aplicação.

Compare as contagens e os tamanhos dos ficheiros e, em seguida, verifique uma amostra representativa de somas de verificação que inclua fotografias antigas e novas, vídeos e ficheiros grandes. Se surgirem erros de cópia ou «ficheiros desaparecidos» por a origem ter sido alterada, deixe de aceitar carregamentos e repita a passagem diferencial, em vez de eliminar a origem para fazer o destino parecer correto.

Restaure a base de dados e a configuração num destino isolado

Inicie o destino com um nome de anfitrião temporário ou numa rede isolada, para que os clientes móveis não possam carregar ficheiros para ele durante a validação. Anexe os ficheiros multimédia copiados nos caminhos de contentor esperados, restaure a base de dados correspondente e reproduza o ambiente, os segredos, as redes e as definições do proxy necessários para essa versão.

Um relato de 2026 sobre uma migração faseada de servidor mostra por que motivo os operadores testam o novo anfitrião antes de desativarem o antigo. Use relatos deste tipo para identificar possíveis falhas, mas baseie-se nos seus registos conhecidos para determinar se a migração preservou realmente o estado.

Pare se o destino abrir como uma instalação nova, indicar que falta armazenamento ou propor uma inicialização destrutiva. Estes sintomas costumam indicar que a base de dados ou as montagens não são as esperadas. Corrija primeiro o caminho ou o destino do restauro; não carregue ficheiros novos para uma instância aparentemente vazia, criando dois históricos em conflito.

Só faça a transferência depois de os utilizadores, o histórico e as novas gravações passarem na verificação

Inicie sessão com cada utilizador de referência e verifique a pertença a álbuns, os favoritos, a partilha, o estado da pesquisa ou das pessoas, os originais representativos, as marcas temporais e as contagens esperadas da biblioteca. Em seguida, carregue uma nova fotografia de teste e confirme que aparece, é processada e continua disponível após o reinício de um contentor.

Altere o DNS de produção ou o destino do proxy apenas depois de o teste isolado passar. Mantenha a instância antiga parada, mas recuperável, para que os dois sistemas não possam aceitar gravações em simultâneo. Preserve a cópia de segurança da base de dados anterior à migração e os ficheiros multimédia de origem até o novo anfitrião ter concluído as cópias de segurança regulares e, pelo menos, um teste de restauro.

Reverta se as contagens divergirem, se relações conhecidas desaparecerem, se os novos carregamentos forem gravados no disco errado ou se o destino falhar após o reinício. Escale o problema indicando as versões de origem e de destino, a data e hora da cópia de segurança da base de dados, os mapeamentos de montagem, os registos de cópia, as diferenças de permissões e o primeiro item de verificação que falhou.

Assistência e dicas

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.