---
title: "Migrar de outro servidor Immich"
description: "Como transferir fotos, vídeos e álbuns de uma instância Immich auto-alojada para o PixelUnion com o Immich Go"
url: "https://pixelunion.eu/pt/help/migrating/migrate-immich/"
weight: 6
---


Se você já usa um servidor Immich auto-alojado e deseja mover sua biblioteca para o PixelUnion, pode fazê-lo diretamente com o [Immich Go](https://github.com/simulot/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](https://github.com/simulot/immich-go/releases/latest) 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: transferir o Immich Go

Acesse a [página de versões do Immich Go](https://github.com/simulot/immich-go/releases/latest) e baixe a versão para o seu sistema operacional:

- **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` 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 ficheiros 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 ficheiros.

## 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 ficheiros já transferidos e tentará novamente as partes incompletas.

Se tiver problemas, [entre em contacto com nossa equipa de suporte](/support/).