Migra Immich come migrazione dello stato applicativo, non come semplice copia di cartelle: conserva il database, l'albero dei file multimediali, la configurazione, i segreti e i percorsi che li collegano.
Una migrazione può sembrare riuscita perché ogni JPEG è presente sul nuovo disco, mentre mancano account, album, persone, condivisioni, preferiti o relazioni storiche. Crea prima un punto di rollback, acquisisci uno stato sorgente coerente, copialo senza modificare gli identificatori, ripristinalo su una destinazione isolata ed effettua il passaggio solo dopo aver verificato che le attività domestiche funzionino come prima.
Fai l'inventario dello stato da trasferire nel suo insieme
Elenca il database PostgreSQL, i file multimediali caricati, i dati generati che intendi conservare, le definizioni delle librerie esterne, la configurazione di Compose o dell'app, i valori dell'ambiente, i segreti, i nomi di rete e le mappature di archiviazione attuali. Segna quali elementi sono autorevoli e quali possono essere rigenerati dopo il ripristino.
Una discussione del 2026 sulla migrazione e su come preservare gli utenti di Immich durante lo spostamento ribadisce il punto fondamentale: lo stato di utenti e libreria dipende dal database e dai percorsi montati, non dall'immagine del container. Considera i comandi della community come esempi e adattali alla versione esatta che hai installato.
Prima dello spostamento, prepara un breve elenco di elementi da verificare: due utenti, diversi album, preferiti, elementi condivisi, una persona o un risultato di ricerca, contenuti vecchi e recenti e, se presente, un percorso di libreria esterna. Questi elementi noti renderanno la verifica post-migrazione molto più efficace del semplice confronto delle dimensioni totali dei file.
Crea un punto di ripristino coerente prima della copia
Sospendi i nuovi caricamenti o pianifica una finestra di manutenzione, così che la sorgente non subisca modifiche durante l'acquisizione dello stato da migrare. Esegui un backup nativo del database e proteggi i file multimediali e la configurazione sorgente. Dopo l'acquisizione, lascia intatta l'istanza originale finché la destinazione non avrà superato le verifiche.
La guida al ripristino di ZimaSpace su come ripristinare insieme i componenti di una libreria fotografica spiega perché gli originali, lo stato del catalogo e la configurazione che definisce i percorsi devono corrispondere a un punto di ripristino compatibile. Lo stesso principio vale per una migrazione.
Non usare la directory del database di produzione attivo come normale destinazione per la copia di file mentre è in uso. Se i tempi di inattività devono essere brevi, usa un dump specifico del database e un metodo di archiviazione di cui conosci l'ordine di acquisizione. La possibilità di ripristinare una migrazione dipende dal punto a cui puoi tornare, non dal numero di file copiati.
Copia i file multimediali mantenendo intatti percorsi e autorizzazioni
Copia l'albero dei file multimediali nella destinazione senza riorganizzare le cartelle durante la migrazione. Mantieni proprietà, autorizzazioni, timestamp e tutte le funzionalità del file system da cui dipende la tua installazione. Se il percorso visibile dal container deve rimanere invariato, modifica la sorgente del bind sul lato host mantenendo stabile la mappatura all'interno del container.
L’attuale flusso di lavoro per la migrazione con rsync illustra la modalità archivio, le simulazioni, i trasferimenti riprendibili e i rischi delle opzioni di mirroring distruttive. Esegui un confronto di prova prima di qualsiasi eliminazione e verifica la destinazione, senza presumere che un comando completato equivalga a una migrazione completa dell’applicazione.
Confronta il numero e le dimensioni dei file, quindi verifica un campione rappresentativo di checksum tra vecchie foto, nuove foto, video e file di grandi dimensioni. Se compaiono errori di copia o «file scomparsi» perché la sorgente è cambiata, interrompi l’accettazione dei caricamenti e ripeti il passaggio differenziale, invece di eliminare la sorgente per far sembrare completa la destinazione.
Ripristina il database e la configurazione su una destinazione isolata
Avvia la destinazione con un hostname temporaneo o su una rete isolata, in modo che i client mobili non possano caricarvi file durante la convalida. Collega i file multimediali copiati ai percorsi previsti del container, ripristina il database corrispondente e ricrea l’ambiente, i segreti, le reti e le impostazioni del proxy necessari per quella versione.
Un resoconto del 2026 su una migrazione graduale di un server mostra perché gli operatori testano il nuovo host prima di dismettere quello vecchio. Usa resoconti simili per individuare possibili problemi, ma lascia che siano i tuoi dati noti a stabilire se la migrazione ha effettivamente preservato lo stato.
Fermati se la destinazione si apre come una nuova installazione, segnala l’assenza dello spazio di archiviazione o propone un’inizializzazione distruttiva. Questi sintomi di solito indicano che il database o i mount non sono quelli previsti. Correggi prima il percorso o la destinazione del ripristino; non caricare nuovi file in un’istanza apparentemente vuota, creando due cronologie in conflitto.
Esegui il passaggio solo dopo aver verificato utenti, cronologia e nuove scritture
Accedi con ciascun utente di riferimento e verifica l’appartenenza agli album, i preferiti, la condivisione, lo stato della ricerca o delle persone, alcuni file originali rappresentativi, le date e i conteggi previsti della raccolta. Poi carica una nuova foto di test e conferma che venga visualizzata, elaborata e mantenga la propria presenza dopo il riavvio di un container.
Modifica il DNS di produzione o la destinazione del proxy solo dopo aver superato il test isolato. Mantieni la vecchia istanza arrestata ma recuperabile, in modo che entrambi i sistemi non possano accettare scritture contemporaneamente. Conserva il backup del database precedente alla migrazione e i file multimediali originali finché il nuovo host non avrà completato i backup ordinari e almeno un test di ripristino.
Esegui il rollback se i conteggi non coincidono, le relazioni note scompaiono, i nuovi caricamenti vengono scritti sul disco sbagliato o la destinazione non funziona dopo il riavvio. Per l’escalation, includi le versioni di origine e destinazione, la data e l’ora del backup del database, le mappature dei mount, i log di copia, le differenze nei permessi e il primo controllo di verifica non superato.
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...



