Come ho trasferito 14000 foto su ZimaCube 2 senza perdere alcun dato — Guida alla migrazione di Immich

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

💡 In evidenza nella community: u/Ambitious_Shallot_79, r/minilab

Hai una libreria fotografica. Anni di ricordi. Album organizzati con cura. Volti a cui hai aggiunto tag. Link condivisi che hai inviato alla famiglia.

Poi aggiorni il NAS — e ti rendi conto che spostare i file non basta. Senza il database, perdi ogni album, ogni tag dei volti, ogni ricordo che hai curato. Le foto ci sono, ma l’organizzazione è scomparsa.

Ho appena spostato 14.505 foto e 925 video — 134 GiB in totale — da un server ZimaOS assemblato da me a ZimaCube 2. Tutti gli album sono rimasti intatti. Tutti i tag dei volti sono stati trasferiti. Tutti i link condivisi funzionano ancora.

Ecco esattamente come ho fatto, cosa ha rischiato di andare storto e cosa ha offerto ZimaCube 2 che la mia vecchia configurazione non poteva offrire.

Perché Immich, perché adesso

Immich è diventato la soluzione fotografica self-hosted di riferimento per un motivo. Offre funzionalità al livello di Google Foto — riconoscimento facciale, ricerca semantica, backup automatici dal telefono, album condivisi — senza inviare le tue foto al server di qualcun altro.

Ma Immich custodisce la sua essenza in PostgreSQL. Il database contiene gli album, i vettori dei volti, i gruppi di persone, gli embedding CLIP per la ricerca intelligente e tutti i metadati che rendono la libreria davvero tua. Se sposti i file senza il database, ottieni una cartella piena di foto e un’istanza di Immich vuota.

Questa migrazione aveva una regola: zero perdita di dati. Il vecchio server non sarebbe stato cancellato finché quello nuovo non fosse stato verificato.

Cosa memorizza davvero Immich (e perché è importante)

Prima di toccare qualsiasi file, ho stabilito esattamente cosa doveva essere spostato:

Componente Posizione Contenuti Da migrare?
pgdata /DATA/AppData/immich/pgdata PostgreSQL completo — album, volti, persone, metadati ✅ Critico
cache dei modelli /DATA/AppData/immich/model-cache Modelli CLIP/di riconoscimento facciale scaricati ✅ Evita di scaricarli di nuovo
Libreria fotografica /DATA/Gallery/immich 14.505 foto + 925 video + miniature (134 GiB) ✅ File multimediali effettivi
Backup automatici /DATA/Gallery/immich/backups Gli ultimi 14 snapshot giornalieri del database 💡 Già presente
🎁 Spostare solo i file delle foto, senza la directory pgdata, ti dà tutte le foto ma nessuno dei tuoi album, tag dei volti, persone, ricordi o link condivisi. Immich considera PostgreSQL l’unica fonte attendibile. Entrambi devono essere spostati insieme.

Immich crea anche backup automatici del database ogni giorno alle 2:00, conservando gli ultimi 14 nella directory dei backup. Prima di eseguire un dump manuale, controlla se è già presente un backup automatico recente.

Il metodo: app File di ZimaOS (copia via LAN)

Entrambe le macchine usano ZimaOS sulla stessa LAN. Questo significava che potevo usare l’app File integrata per un trasferimento diretto sulla LAN — senza unità esterne, comandi SCP o spazio di archiviazione intermedio.

Passaggio 1: monta la macchina di origine

Sullo ZimaCube 2, apri l’app File → + Aggiungi spazio di archiviazione → Spazio di archiviazione LAN → inserisci l’indirizzo IP locale della macchina di origine e autenticati. Ora il file system della macchina di origine appare come spazio di archiviazione consultabile sullo ZimaCube 2.

Passaggio 2: arresta Immich sulla macchina di origine

È il passaggio che molti saltano e di cui poi si pentono. Arresta Immich prima di copiare. Un’istanza di PostgreSQL in esecuzione scrive continuamente: devi portare il database in uno stato coerente e con tutte le scritture completate. Sulla macchina di origine: App Store di ZimaOS → Immich → Arresta.

Passaggio 3: copia entrambe le directory

Dall’app File dello ZimaCube 2, vai alla posizione di origine montata e seleziona:

Percorso di origine Percorso di destinazione sullo ZimaCube 2
/DATA/AppData/immich /DATA/AppData/immich
/DATA/Gallery/immich /DATA/Gallery/immich

Seleziona entrambe le posizioni e premi Migra. Scegli: Sovrascrivi nella destinazione e Mantieni gli originali nell’origine — non eliminare l’origine prima di aver verificato.

⚡ Con la connessione 2.5GbE dello ZimaCube 2, il trasferimento di 134 GiB richiede circa 10–15 minuti. Il mio vecchio server fai-da-te era limitato a 1GbE: lo stesso trasferimento avrebbe richiesto 30–40 minuti. È il tipo di differenza concreta che non si nota leggendo una scheda tecnica, ma che conta ogni volta che si spostano dati.

Passaggio 4: installa Immich sullo ZimaCube 2

Apri l’App Store di ZimaOS e cerca Immich. Avvertenza fondamentale: l’App Store potrebbe mostrare più varianti di Immich. Devi installare esattamente la stessa variante usata dalla macchina di origine:

Immich (app ufficiale ZimaOS/CasaOS) — usa questa se era quella che avevi prima

BigBearCasaOS Immich — variabili docker-compose diverse, credenziali Postgres diverse, nome del database diverso — incompatibile con la copia diretta di pgdata dall’app ufficiale

🔑 Le variabili di docker-compose — nome utente di Postgres, password, nome del database, modalità di rete — sono incorporate nella definizione dell’app. Qualsiasi differenza tra le varianti dell’app di origine e di destinazione impedirà a Immich di connettersi al database ripristinato. Questo è il problema più comune nelle migrazioni di Immich.

Dopo l’installazione, non avviare subito l’app. Al primo avvio, Immich rileverà la directory pgdata esistente e vi si collegherà invece di inizializzare un nuovo database vuoto.

Ricerca dell’applicazione «immich» nell’App Store di ZimaOS / CasaOS durante la configurazione del NAS

Passaggio 5: accedi con le credenziali esistenti

Apri Immich all’indirizzo http://192.168.x.x:2283 e accedi con lo stesso nome utente e la stessa password dell’istanza di origine. L’intera libreria — album, volti, persone, impostazioni — sarà esattamente come prima.

Schermata iniziale di benvenuto dell’applicazione Immich e pulsante per iniziare dopo la migrazione riuscita del database

Passaggio 6: verifica le code dei processi

Vai a Profilo → Amministrazione → Code dei processi. Dopo la migrazione di pgdata, il database contiene già tutti i risultati elaborati in precedenza, quindi la maggior parte delle code dovrebbe mostrare Attivi: 0 / In attesa: 0.

Se una coda mostra un conteggio sotto Mancanti, fai clic sul pulsante «Mancanti» per elaborare solo gli elementi non ancora elaborati:

Coda Quando eseguire i processi mancanti
Genera miniature Se alcune foto hanno anteprime vuote
Estrai metadati Se mancano dati GPS, posizione o data dagli elementi
Ricerca intelligente Se la ricerca semantica non restituisce risultati
Rilevamento dei volti Se i dati sui volti sembrano incompleti

Statistiche della migrazione

Metrica Valore
Foto migrate 14,505
Video migrati 925
Dati totali 134 GiB
Tempo di trasferimento (2.5GbE) ~12 minuti
Album conservati Tutti
Tag dei volti conservati Tutti
Link condivisi conservati Tutti
Perdita di dati Zero

Perché valeva la pena passare a ZimaCube 2

Non ho fatto la migrazione per ritrovarmi con la stessa esperienza. ZimaCube 2 offre tre miglioramenti che il mio vecchio sistema fai-da-te con ZimaOS non poteva eguagliare:

Trasferimenti 2.5GbE. Le librerie fotografiche crescono. Ogni backup completo, ogni importazione di grandi dimensioni, ogni migrazione beneficia della larghezza di banda 2,5 volte superiore rispetto al Gigabit standard. Il doppio 2.5GbE di ZimaCube 2 mi permette di saturare la connessione durante un backup, mentre il resto della rete rimane reattivo.

Archiviazione NVMe per il database. Il database PostgreSQL di Immich offre prestazioni decisamente migliori su NVMe rispetto ai dischi rigidi meccanici. Generazione delle miniature, query di ricerca intelligente, riconoscimento facciale: tutto legge da pgdata. Sul pool NVMe di ZimaCube 2, le operazioni sul database che prima si bloccavano sull’HDD ora sono istantanee.

Espandibilità a 6 alloggiamenti. 134 GiB oggi. E l’anno prossimo? ZimaCube 2 ha sei alloggiamenti SATA e quattro slot M.2 nel 7th Bay, quindi questa libreria fotografica può crescere per anni senza esaurire lo spazio di archiviazione.

IceWhale ZimaCube 2, NAS a 6 alloggiamenti con vani frontali per unità hot-swap, per un'archiviazione self-hosted ad alte prestazioni

Migra la tua libreria di foto su ZimaCube 2 →

Stai configurando il tuo spazio foto self-hosted? Leggi la nostra guida ai dispositivi di archiviazione cloud personale, l'approfondimento su Docker e CI/CD su ZimaCube 2 e il nostro unboxing di ZimaCube 2 Pro.

Domande frequenti

Posso migrare Immich su ZimaCube 2 senza perdere i miei album e i tag dei volti?

Sì — ma devi copiare sia i file delle foto sia la directory pgdata (database PostgreSQL). Il database contiene tutti gli album, i vettori dei volti, i gruppi di persone e i metadati. Se sposti solo le foto, avrai i file ma non la loro organizzazione. Copia entrambe le directory insieme e la tua libreria resterà intatta.

Qual è il modo più veloce per trasferire i dati di Immich su ZimaCube 2?

Se entrambi i computer sono connessi alla stessa LAN e usano ZimaOS, utilizza l'app File integrata con il montaggio di Archiviazione LAN. Con la connessione 2.5GbE di ZimaCube 2, il trasferimento di 134 GiB richiede circa 10–15 minuti. Per librerie più grandi o computer su reti diverse, la soluzione migliore è un'unità USB esterna.

La versione di Immich nell'App Store è importante durante la migrazione?

Sì — è fondamentale. L'App Store di ZimaOS può mostrare diverse versioni di Immich (ufficiale o BigBearCasaOS). Usano variabili docker-compose diverse: credenziali PostgreSQL, nomi dei database e configurazioni di rete incompatibili. Installa esattamente la stessa versione usata dal computer di origine, altrimenti il database ripristinato non si collegherà.

Devo arrestare Immich sul dispositivo di origine prima di copiare i dati?

Sì. Un'istanza PostgreSQL in esecuzione scrive continuamente. Copiare un database attivo comporta il rischio di ottenere uno stato incoerente. Arresta Immich sul computer di origine, copia le cartelle e poi avvialo sul dispositivo di destinazione. Puoi lasciare spento il computer di origine o tenerlo acceso come backup finché non hai verificato la migrazione.

Quanto spazio di archiviazione serve a Immich su ZimaCube 2?

Pianifica spazio per la tua libreria di foto, più quello necessario per il database PostgreSQL (che cresce insieme alla libreria), la cache delle miniature e le versioni transcodificate dei video. Una libreria da 134 GiB con 14.500 foto occupa circa 150–160 GiB in totale, spazio aggiuntivo incluso. I sei alloggiamenti SATA di ZimaCube 2 ti permettono di espanderti.

Hub della campagna Zima

Altre letture

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.