Migrare da un altro server Immich

Se stai già utilizzando un server Immich self-hosted e vuoi spostare la tua libreria su PixelUnion, puoi farlo direttamente con Immich Go. La migrazione trasferisce foto, video e struttura degli album da un’istanza Immich all’altra, senza dover passare dal tuo computer locale.

Cosa ti servirà

• Accesso al tuo server Immich esistente (deve essere raggiungibile in rete)
• Una chiave API del tuo server Immich esistente
• Una chiave API del tuo account PixelUnion
• Immich Go scaricato sul tuo computer

Passo 1: Creare una chiave API sul server sorgente

1. Accedi al tuo server Immich esistente
2. Clicca sull’icona del profilo (in alto a destra) e vai su Impostazioni account
3. Vai su Chiavi API e clicca su Nuova chiave API
4. Dagli un nome (es. “Migrazione”) e assicurati che i permessi asset.read e asset.copy siano abilitati
5. Copia la chiave generata e conservala in un posto sicuro

Passo 2: Creare una chiave API su PixelUnion

1. Accedi al tuo dominio PixelUnion (es. https://tuonome.pixelunion.eu)
2. Clicca sull’icona del profilo (in alto a destra) e vai su Impostazioni account
3. Vai su Chiavi API e clicca su Nuova chiave API
4. Dagli un nome (es. “Migrazione”) e copia la chiave generata

Passo 3: Scaricare Immich Go

Vai alla pagina delle versioni di Immich Go e scarica la versione per il tuo sistema operativo:

• Windows: il file .exe
• macOS: il file con darwin nel nome
• Linux: il file con linux nel nome

Estrai l’archivio e posiziona l’eseguibile immich-go in una cartella comoda.

Passo 4: Avviare la migrazione

Apri un terminale, spostati nella cartella con immich-go ed esegui:

macOS / Linux:

./immich-go upload from-immich \
  --from-server=https://tuo-vecchio-server.com \
  --from-api-key=TUA_CHIAVE_API_SORGENTE \
  --server=https://tuonome.pixelunion.eu \
  --api-key=TUA_CHIAVE_API_PIXELUNION

Windows:

.\immich-go.exe upload from-immich --from-server=https://tuo-vecchio-server.com --from-api-key=TUA_CHIAVE_API_SORGENTE --server=https://tuonome.pixelunion.eu --api-key=TUA_CHIAVE_API_PIXELUNION

Sostituisci i segnaposto con gli URL reali dei tuoi server e le tue chiavi API.

Immich Go si connette a entrambi i server, rileva i file già presenti nella destinazione e trasferisce tutto il resto. La struttura degli album viene preservata automaticamente.

Suggerimenti

Accelera la migrazione eseguendo più trasferimenti in parallelo:

./immich-go upload from-immich \
  --from-server=https://tuo-vecchio-server.com \
  --from-api-key=TUA_CHIAVE_API_SORGENTE \
  --server=https://tuonome.pixelunion.eu \
  --api-key=TUA_CHIAVE_API_PIXELUNION \
  --concurrent-tasks=4

Migrare solo album specifici:

./immich-go upload from-immich \
  --from-server=https://tuo-vecchio-server.com \
  --from-api-key=TUA_CHIAVE_API_SORGENTE \
  --server=https://tuonome.pixelunion.eu \
  --api-key=TUA_CHIAVE_API_PIXELUNION \
  --from-album="Famiglia" \
  --from-album="Vacanze"

Riprendere una migrazione interrotta: Se il processo viene interrotto, esegui semplicemente di nuovo lo stesso comando. Immich Go tiene traccia di ciò che è già stato trasferito e salta quei file.

Quanto tempo ci vorrà?

La velocità di migrazione dipende dalle dimensioni della tua libreria e dalla tua connessione internet. Come guida approssimativa:

• 10 GB: circa 30-60 minuti
• 100 GB: diverse ore, meglio eseguire durante la notte
• 500 GB o più: pianifica un’intera giornata o più

Risoluzione dei problemi

Errori di connessione: Verifica che l’URL del tuo server sorgente sia corretto e raggiungibile dal tuo computer. L’URL deve includere https:// o http://.

Errori di permesso: Verifica che la chiave API del tuo server sorgente abbia i permessi asset.read e asset.copy abilitati.

Album mancanti: Gli album vengono creati durante il trasferimento. Se un album manca dopo il completamento della migrazione, esegui di nuovo il comando – Immich Go salterà i file già trasferiti e riproverà le parti incomplete.

Se riscontri problemi, contatta il nostro team di supporto.