Migrar de outro servidor Immich

Se já usa um servidor Immich auto-alojado e deseja mover a sua biblioteca para o PixelUnion, pode fazê-lo diretamente com o Immich Go. A migração transfere as suas fotos, vídeos e estrutura de álbuns de uma instância Immich para outra, sem precisar de passar pelo seu computador local.

O que vai precisar

• Acesso ao seu servidor Immich existente (deve estar acessível pela rede)
• Uma chave de API do seu servidor Immich existente
• Uma chave de API da sua conta PixelUnion
• Immich Go descarregado para o seu computador

Passo 1: criar uma chave de API no servidor de origem

1. Inicie sessão no seu servidor Immich existente
2. Clique no ícone do seu perfil (canto superior direito) e vá para Definições de Conta
3. Navegue até Chaves de API e clique em Nova Chave de API
4. Dê-lhe um nome (ex.: “Migração”) e certifique-se de que as permissões asset.read e asset.copy estejam ativadas
5. Copie a chave gerada e guarde-a num lugar seguro

Passo 2: criar uma chave de API no PixelUnion

1. Inicie sessão no seu domínio PixelUnion (ex.: https://seunome.pixelunion.eu)
2. Clique no ícone do seu perfil (canto superior direito) e vá para Definições de Conta
3. Navegue até Chaves de API e clique em Nova Chave de API
4. Dê-lhe um nome (ex.: “Migração”) e copie a chave gerada

Passo 3: transferir o Immich Go

Aceda à página de versões do Immich Go e transfira a versão para o seu sistema operativo:

• Windows: o ficheiro .exe
• macOS: o ficheiro com darwin no nome
• Linux: o ficheiro com linux no nome

Extraia o ficheiro e coloque o executável immich-go numa pasta conveniente.

Passo 4: executar a migração

Abra um terminal, navegue até à pasta com o immich-go e execute:

macOS / Linux:

./immich-go upload from-immich \
  --from-server=https://seu-servidor-antigo.com \
  --from-api-key=SUA_CHAVE_API_ORIGEM \
  --server=https://seunome.pixelunion.eu \
  --api-key=SUA_CHAVE_API_PIXELUNION

Windows:

.\immich-go.exe upload from-immich --from-server=https://seu-servidor-antigo.com --from-api-key=SUA_CHAVE_API_ORIGEM --server=https://seunome.pixelunion.eu --api-key=SUA_CHAVE_API_PIXELUNION

Substitua os marcadores pelos URLs reais dos seus servidores e pelas suas chaves de API.

O Immich Go liga-se aos dois servidores, deteta ficheiros já presentes no destino e transfere todo o resto. A sua estrutura de álbuns é preservada automaticamente.

Dicas

Acelere a migração executando múltiplas transferências em paralelo:

./immich-go upload from-immich \
  --from-server=https://seu-servidor-antigo.com \
  --from-api-key=SUA_CHAVE_API_ORIGEM \
  --server=https://seunome.pixelunion.eu \
  --api-key=SUA_CHAVE_API_PIXELUNION \
  --concurrent-tasks=4

Migrar apenas álbuns específicos:

./immich-go upload from-immich \
  --from-server=https://seu-servidor-antigo.com \
  --from-api-key=SUA_CHAVE_API_ORIGEM \
  --server=https://seunome.pixelunion.eu \
  --api-key=SUA_CHAVE_API_PIXELUNION \
  --from-album="Família" \
  --from-album="Férias"

Retomar uma migração interrompida: Se o processo for interrompido, basta executar o mesmo comando novamente. O Immich Go rastreia o que já foi transferido e ignora esses ficheiros.

Quanto tempo vai demorar?

A velocidade de migração depende do tamanho da sua biblioteca e da sua ligação à internet. Como referência aproximada:

• 10 GB: cerca de 30 a 60 minutos
• 100 GB: várias horas, melhor executar durante a noite
• 500 GB ou mais: planeie um dia inteiro ou mais

Resolução de problemas

Erros de ligação: Verifique se o URL do seu servidor de origem está correto e acessível pelo seu computador. O URL deve incluir https:// ou http://.

Erros de permissão: Verifique se a chave de API do seu servidor de origem tem as permissões asset.read e asset.copy ativadas.

Álbuns não aparecem: Os álbuns são criados durante a transferência. Se um álbum estiver em falta após a migração, execute o comando novamente – o Immich Go ignorará os ficheiros já transferidos e tentará novamente as partes incompletas.

Se tiver problemas, entre em contacto com a nossa equipa de suporte.