Uma migração segura do Immich começa por confirmar o que tem de ser preservado antes de copiar seja o que for: os ficheiros de fotografias, a base de dados e as definições de implementação que os voltam a associar no novo anfitrião.
Num servidor doméstico, o risco da migração costuma resultar da transferência dessas partes em momentos diferentes ou do arranque do destino com os caminhos errados. Trate o servidor antigo como cópia de recurso para reversão, suspenda as gravações que possam ser evitadas, registe a versão atual e os mapeamentos de armazenamento e, em seguida, transfira um único conjunto de dados verificado para a nova máquina. A lista de verificação abaixo mantém o processo reversível até que a nova instância consiga iniciar sessão, encontrar a biblioteca original, processar tarefas e sobreviver a um reinício sem voltar a um estado vazio.
Congele a Origem e Registe o Estado Comprovadamente Funcional
Comece no servidor em funcionamento, não no novo. Registe a versão do Immich, a definição do Compose ou da loja de aplicações, os valores das variáveis de ambiente que controlam os caminhos da base de dados e do armazenamento, a localização da biblioteca de fotografias, a localização da base de dados e quaisquer pontos de montagem de bibliotecas externas. Registe também o URL atual do servidor e a conta de utilizador que usará para a validação.
O objetivo deste inventário é evitar que uma migração se transforme silenciosamente numa atualização, numa reformulação dos caminhos e numa alteração da rede, tudo ao mesmo tempo. Mantenha a versão da aplicação e a organização lógica do armazenamento tão estáveis quanto possível até a restauração ser validada; as alterações de versão podem ser feitas depois de confirmar o destino.
Antes de copiar, pare ou suspenda os novos carregamentos, se isso for aceitável para as pessoas da sua casa. Se tal não for prático, defina uma janela de transição e planeie uma sincronização final breve. No final desta etapa, deverá ter um mapa escrito das origens que lhe permita saber onde estão os ficheiros originais, onde se encontra o estado da base de dados e que configuração recria as mesmas relações.
Capture a Base de Dados, os Recursos e a Configuração num Único Conjunto de Migração
Trate a base de dados e os ficheiros multimédia como um único conjunto de recuperação, em vez de os considerar duas cópias de segurança independentes. As cópias de segurança atuais da base de dados do Immich contêm metadados e referências a ficheiros, não as próprias fotografias ou vídeos, pelo que a cópia de segurança da base de dados tem de acompanhar o conteúdo correspondente de UPLOAD_LOCATION e quaisquer dados de bibliotecas externas que gere separadamente.
Um conjunto de migração utilizável precisa dos recursos, do estado do PostgreSQL e da configuração que os volta a ligar. Um conjunto completo de cópias de segurança do Immich inclui recursos carregados, uma cópia de segurança da base de dados compatível e a configuração da implementação, sendo os testes de restauro usados para comprovar que o conjunto funciona. Mantenha estes elementos juntos para que o destino possa ser associado a um único ponto de recuperação.
Verifique o conjunto de migração antes de alterar o destino. Confirme que o despejo da base de dados não está vazio, verifique alguns ficheiros originais da biblioteca copiada e guarde os ficheiros Compose e de ambiente na mesma pasta de migração ou no mesmo conjunto de documentação. Se não conseguir verificar algum componente, pare aqui e faça uma nova cópia em vez de tentar compensar no novo servidor.
Prepare o novo anfitrião sem criar um estado concorrente
Crie primeiro os diretórios e as montagens de destino e, em seguida, confirme que o novo anfitrião deteta os discos ou partilhas de rede previstos nos caminhos exatos que pretende usar. A ausência de uma montagem NAS pode deixar para trás um diretório vazio comum, e um contentor pode inicializar-se sem problemas nesse caminho alternativo.
Instale o ambiente de execução e recrie a definição da implementação, mas não deixe uma instância vazia do Immich acumular carregamentos ou configuração antes de restaurar o estado antigo. Mantenha as credenciais, o nome da base de dados, as variáveis de armazenamento e os destinos de montagem das bibliotecas externas alinhados com a origem, a menos que o plano de migração inclua explicitamente uma alteração controlada dos caminhos.
Se o novo servidor exigir caminhos diferentes no anfitrião, mapeie-os deliberadamente, mantendo coerentes os caminhos visíveis no contentor e as expectativas da base de dados. O destino só está pronto quando as montagens efetivas apontarem para as localizações dos dados copiados e conseguir explicar cada conversão de caminhos antes de iniciar a aplicação completa.
Restaure o estado e volte a ligar todos os caminhos de armazenamento
Restaure a base de dados usando o método de recuperação adequado à versão do Immich que criou a cópia de segurança e só inicie os restantes serviços depois de a base de dados estar pronta. Não improvise comandos destrutivos para a base de dados retirados de um guia antigo quando uma instalação mais recente usa um fluxo de restauro diferente.
Durante a transição, mantenha intacta a relação entre a base de dados e o armazenamento antes de retomar a utilização normal. Uma sequência de migração do Immich testada segue o mesmo princípio: a aplicação deve abrir com o estado restaurado da base de dados e os caminhos de multimédia pretendidos, e não inicializar uma biblioteca nova e forçar uma reconstrução de raiz.
Após o arranque, verifique o acesso ao armazenamento antes de iniciar tarefas pesadas em segundo plano. Abra vários ficheiros antigos de datas diferentes, confirme que as miniaturas carregam, verifique um álbum e uma pessoa ou um resultado de pesquisa que existiam antes da migração e certifique-se de que as bibliotecas externas estão legíveis, se as utilizar. Um ecrã de configuração inicial ou uma cronologia vazia é um sinal para parar: volte a verificar a base de dados e as correspondências dos pontos de montagem antes de gravar novos dados.
Valide a carga de trabalho original antes de desativar o servidor antigo
Um primeiro início de sessão bem-sucedido não significa que a migração esteja concluída. Carregue uma fotografia de teste descartável a partir do cliente habitual, confirme que aparece no armazenamento do host esperado, elimine-a através do Immich e verifique se a biblioteca continua saudável. Isto testa o percurso completo de escrita, em vez de apenas comprovar que os dados antigos são legíveis.
Reinicie o novo servidor doméstico e repita as verificações importantes para a sua casa: início de sessão no navegador, ligação da cópia de segurança móvel, algumas fotografias antigas, pesquisa, um vídeo representativo, filas de tarefas e acesso remoto, se fizer parte da configuração habitual. A migração só está concluída quando o mesmo estado persiste após o reinício do host e os pontos de montagem do armazenamento estão disponíveis antes de o Immich iniciar.
Mantenha o servidor antigo desligado, mas sem alterações, durante um período de segurança para poder reverter, em vez de o apagar imediatamente. Se a nova instância começar a gravar numa pasta vazia inesperada, não conseguir reproduzir a biblioteca antiga após um reinício ou apresentar erros de base de dados que não consiga explicar, suspenda os novos carregamentos e volte à origem comprovadamente funcional enquanto compara o conjunto migrado. Só desative o host antigo depois de o destino ter passado por uma utilização normal e por um teste de cópia de segurança recente.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



