Una migrazione sicura di Immich inizia verificando cosa deve essere conservato prima di copiare qualsiasi cosa: i file delle foto, il database e le impostazioni di distribuzione che li ricollegano sul nuovo host.
Su un home server, il rischio della migrazione deriva di solito dallo spostare questi elementi in momenti diversi o dall'avviare la destinazione con percorsi errati. Considera il vecchio server come copia di ripristino, blocca le scritture evitabili, annota la versione attuale e le mappature dello spazio di archiviazione, quindi trasferisci un unico insieme di dati verificato alla nuova macchina. La checklist qui sotto mantiene reversibili le operazioni finché la nuova istanza non riesce ad accedere, a trovare la libreria originale e a elaborare i processi, e non supera un riavvio senza ritrovarsi vuota.
Blocca le modifiche all'origine e registra lo stato funzionante noto
Inizia dal server funzionante, non da quello nuovo. Annota la versione di Immich, la definizione di Compose o dell'app store, i valori delle variabili d'ambiente che determinano i percorsi del database e dello spazio di archiviazione, la posizione della libreria fotografica, quella del database e tutti i mount delle librerie esterne. Annota anche l'URL attuale del server e l'account utente che userai per la verifica.
Lo scopo di questo inventario è evitare che la migrazione si trasformi silenziosamente in un aggiornamento, una riorganizzazione dei percorsi e una modifica di rete, tutto insieme. Mantieni la versione dell'applicazione e la struttura logica dello spazio di archiviazione il più stabili possibile finché il ripristino non è completato; le modifiche di versione si potranno gestire dopo aver verificato la destinazione.
Prima di copiare, interrompi o sospendi i nuovi caricamenti, se in casa potete permettervelo. Se non è praticabile, stabilisci una finestra per il passaggio e pianifica una sincronizzazione finale breve. Al termine di questa fase, dovrai avere una mappa scritta dell'origine che ti permetta di rispondere a queste domande: dove si trovano gli originali, dove risiedono i dati del database e quale configurazione ricrea gli stessi collegamenti.
Acquisisci database, file e configurazione come un unico insieme per la migrazione
Tratta il database e i file multimediali come un unico insieme di ripristino, non come due backup indipendenti. Gli attuali backup del database di Immich contengono metadati e riferimenti ai file, non le foto o i video stessi: perciò il backup del database deve essere trasferito insieme ai contenuti corrispondenti di UPLOAD_LOCATION e agli eventuali dati delle librerie esterne che gestisci separatamente.
Una migrazione utilizzabile richiede le risorse, lo stato di PostgreSQL e la configurazione necessaria per ricollegarli. Un set completo di backup di Immich include le risorse caricate, un backup del database supportato e la configurazione del deployment; i test di ripristino servono a dimostrare che il set funziona. Tieni questi elementi insieme, così da poter associare la destinazione a un unico punto di ripristino.
Verifica i dati della migrazione prima di intervenire sulla destinazione. Controlla che il dump del database non sia vuoto, esamina alcuni file originali della libreria copiata e conserva i file Compose e dell'ambiente nella stessa cartella della migrazione o nello stesso insieme di documenti. Se non riesci a verificare un componente, fermati qui e crea una nuova copia anziché cercare di compensare sul nuovo server.
Prepara il nuovo host senza creare uno stato in conflitto
Crea prima le directory e i mount di destinazione, poi verifica che il nuovo host rilevi i dischi o le condivisioni di rete previsti esattamente nei percorsi che intendi usare. Se manca un mount NAS, potrebbe rimanere una normale directory vuota e il container potrebbe inizializzarsi tranquillamente su quel percorso di ripiego.
Installa il runtime e ricrea la definizione del deployment, ma non lasciare che un'istanza vuota di Immich accumuli caricamenti o configurazione prima di aver ripristinato lo stato precedente. Mantieni credenziali, nome del database, variabili di archiviazione e percorsi di mount delle librerie esterne allineati a quelli dell'origine, a meno che il piano di migrazione non preveda esplicitamente una modifica controllata dei percorsi.
Se il nuovo server richiede percorsi diversi sul sistema host, mappali deliberatamente mantenendo coerenti i percorsi visibili nel container e le aspettative del database. La destinazione è pronta solo quando i mount effettivi puntano alle posizioni dei dati copiati e sai spiegare ogni conversione dei percorsi prima di avviare l'intera applicazione.
Ripristina lo stato e ricollega ogni percorso di archiviazione
Ripristina il database seguendo la procedura di ripristino appropriata per la versione di Immich che ha creato il backup, quindi avvia i servizi rimanenti solo dopo che il database è pronto. Non improvvisare comandi distruttivi sul database basandoti su una guida più datata quando una nuova installazione usa una procedura di ripristino diversa.
Durante il passaggio, mantieni intatta la relazione tra database e spazio di archiviazione prima di riprendere l’uso normale. Una procedura di migrazione di Immich testata segue lo stesso principio: l’applicazione deve aprirsi con lo stato del database ripristinato e i percorsi multimediali previsti, non inizializzare una nuova libreria e imporre una ricostruzione da zero.
Dopo l’avvio, controlla l’accesso allo spazio di archiviazione prima di avviare processi in background pesanti. Apri alcuni vecchi contenuti di date diverse, verifica che le miniature vengano caricate, controlla un album e una persona o un risultato di ricerca già presenti prima della migrazione e assicurati che le librerie esterne siano leggibili, se le usi. Una schermata iniziale di configurazione o una cronologia vuota sono segnali per fermarsi: ricontrolla il database e le mappature dei mount prima di scrivere nuovi dati.
Verifica il carico di lavoro originale prima di dismettere il vecchio server
Un primo accesso riuscito non segna la fine di una migrazione. Carica una foto di prova sacrificabile dal client abituale, verifica che appaia nella posizione di archiviazione prevista sull’host, poi eliminala tramite Immich e verifica che la libreria sia ancora integra. In questo modo controlli l’intero percorso di scrittura, invece di dimostrare soltanto che i vecchi dati sono leggibili.
Riavvia il nuovo home server e ripeti i controlli importanti per la tua famiglia: accesso dal browser, connessione per il backup da mobile, alcune vecchie foto, ricerca, un video rappresentativo, code di attività e accesso remoto, se fa parte della configurazione normale. La migrazione è completa solo quando lo stesso stato persiste dopo il riavvio dell’host e i volumi di archiviazione vengono montati prima dell’avvio di Immich.
Mantieni il vecchio server spento ma invariato per un periodo di rollback, invece di cancellarlo subito. Se la nuova istanza inizia a scrivere in una cartella vuota imprevista, non riesce a riprodurre la vecchia libreria dopo il riavvio o mostra errori del database che non sai spiegare, interrompi i nuovi caricamenti e torna alla sorgente affidabile mentre confronti i dati della migrazione. Dismetti il vecchio host solo dopo che la destinazione ha superato l’uso normale e un test di backup recente.
Assistenza e consigli
Altre letture

Come tenere nascosti i video per adulti sul tuo NAS ai tuoi familiari
Tieni privati i video per adulti su un NAS familiare. Controlla le autorizzazioni delle cartelle, l’accesso alle librerie di Plex e Jellyfin, le miniature,...

Cosa controllare prima di caricare un modello della community in Transformers
Usa l’aggiornamento della sandbox Jinja di Transformers per esaminare la provenienza dei modelli, i template di chat, il codice remoto, i pesi serializzati e...

Esegui Mirage in locale: OCR e rilevamento degli oggetti da una sola immagine
Prova il piccolo modello di visione locale di Cactus Compute, verifica l’OCR e l’estrazione degli oggetti con input reali e comprendi i limiti di...



