Migrar de outro servidor Immich

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

O que você vai precisar

• Acesso ao seu servidor Immich existente (ele 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 baixado no seu computador

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

1. Faça login no seu servidor Immich existente
2. Clique no ícone do seu perfil (canto superior direito) e vá para Configurações da conta
3. Navegue até Chaves de API e clique em Nova chave de API
4. Dê um nome a ela (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 em um lugar seguro

Passo 2: Criar uma chave de API no PixelUnion

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

Passo 3: Baixar o Immich Go

Acesse a página de versões do Immich Go e baixe a versão para o seu sistema operacional:

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

Extraia o arquivo e coloque o executável immich-go em uma pasta conveniente.

Passo 4: Executar a migração

Abra um terminal, navegue até a 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 pelas URLs reais dos seus servidores e suas chaves de API.

O Immich Go conecta-se aos dois servidores, detecta arquivos já presentes no destino e transfere todo o resto. 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 arquivos.

Quanto tempo vai demorar?

A velocidade de migração depende do tamanho da sua biblioteca e da sua conexão com a 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: planeje um dia inteiro ou mais

Solução de problemas

Erros de conexão: Verifique se a URL do seu servidor de origem está correta e acessível pelo seu computador. A 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 faltando após a migração, execute o comando novamente – o Immich Go ignorará os arquivos já transferidos e tentará novamente as partes incompletas.

Se tiver problemas, entre em contato com nossa equipe de suporte.