---
title: "Migrare da un altro server Immich"
description: "Come trasferire foto, video e album da un'istanza Immich self-hosted a PixelUnion con Immich Go"
url: "https://pixelunion.eu/it/help/migrating/migrate-immich/"
weight: 6
---


Se stai già utilizzando un server Immich self-hosted e vuoi spostare la tua libreria su PixelUnion, puoi farlo direttamente con [Immich Go](https://github.com/simulot/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](https://github.com/simulot/immich-go/releases/latest) 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](https://github.com/simulot/immich-go/releases/latest) 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](/support/).