Lo stato di Immich è l’insieme di contenuti multimediali, database, identità, configurazione e dati derivati necessari per riprodurre il comportamento previsto della libreria.
I file originali sono essenziali, ma non costituiscono l’intera applicazione. Album, utenti, proprietà, volti, rappresentazioni per la ricerca, mappature dei percorsi e segreti determinano il modo in cui tali file vengono visualizzati e chi può utilizzarli; alcuni sono autorevoli, mentre altri possono essere ricostruiti a fronte di un certo costo.
I contenuti multimediali originali e le relazioni del database costituiscono il nucleo
Le foto e i video originali conservano contenuti insostituibili. Il database conserva il modo in cui Immich interpreta tali contenuti: utenti, proprietà, album, identificatori degli elementi, metadati e relazioni di elaborazione. Nessuno dei due elementi è sufficiente da solo quando l’obiettivo è ripristinare lo stesso servizio domestico, anziché recuperare semplicemente file sparsi.
La guida al backup di Immich di ZimaSpace spiega che una protezione completa include i contenuti multimediali caricati e il database. Questa distinzione offre una definizione utile dello stato: i contenuti multimediali indicano quali byte esistono, mentre i record del database indicano come l’applicazione associa, presenta e controlla tali byte.
Mappa il database e ogni posizione dei contenuti multimediali originali su percorsi persistenti dell’host o del sistema di archiviazione. Conferma che le librerie esterne siano protette dalla propria politica. Non dedurre la persistenza da un percorso interno del container; esamina il volume effettivo o il bind mount che sopravvive all’eliminazione e alla ricreazione del container.
Configurazione e segreti ricreano il perimetro del servizio
Le definizioni Compose, le impostazioni dell’ambiente, le mappature dello storage, le regole del proxy e la configurazione del provider di identità determinano il modo in cui i servizi trovano i dati e comunicano tra loro. Anche password, materiali di firma e credenziali API devono sopravvivere in modo sicuro. Ricostruire i file senza queste impostazioni può lasciare il database raggiungibile con l’identità o i percorsi errati.
Un’analisi della pianificazione dello storage di Immich separa la posizione del database e delle miniature da quella dello storage degli originali in blocco. La lezione è architetturale: un singolo servizio logico può estendersi su diverse posizioni fisiche, quindi l’inventario della persistenza deve seguire ogni mount e dipendenza, non una sola directory del progetto.
Conserva le definizioni della distribuzione nel controllo versione dopo aver rimosso i segreti. Mantieni i segreti in un backup crittografato o in un gestore di segreti con una procedura di ripristino documentata. Registra proprietari e autorizzazioni per i bind mount. Durante un’esercitazione, verifica l’accesso del servizio al database e la lettura dei contenuti multimediali prima di esporre l’accesso remoto o accettare nuovi caricamenti.
I dati derivati possono essere ricostruiti, ma sono operativamente importanti
Le miniature, i video codificati e alcuni risultati dell’apprendimento automatico possono essere rigenerati dagli input autorevoli, a seconda della versione e dei record conservati. Escluderli può ridurre le dimensioni dei backup. Il compromesso consiste nel tempo, nella potenza di calcolo, nel calore e nella minore reattività mentre un server ripristinato ricostruisce una grande libreria familiare.
Una guida indipendente al backup distingue i dati obbligatori relativi a caricamenti, libreria e profili dalle miniature e dai video codificati che Immich può rigenerare. Ciò non rende irrilevanti i dati derivati; offre agli operatori la scelta tra le dimensioni del backup e il tempo necessario per recuperare una navigazione e una riproduzione completamente predisposte.
Misura la velocità di ricostruzione su un campione rappresentativo prima di escludere i dati derivati. Moltiplica con cautela in base alla composizione degli elementi interessati e includi le scritture sullo storage e la contesa con i carichi in primo piano. Se il ritardo risultante viola l’obiettivo di ripristino, proteggi percorsi derivati selezionati o mantieni capacità di calcolo aggiuntiva per la finestra di ricostruzione.
Dimostra la persistenza con un’esercitazione di distruzione dei container
Utilizza una copia temporanea della distribuzione, mai l’ambiente di produzione. Registra gli hash di esempio degli originali, di un album di test, di due account con accessi diversi e di una ricerca nota. Rimuovi solo i container clonati mantenendo lo storage persistente dichiarato, quindi ricrea lo stack a partire dalla configurazione e dai segreti salvati.
Un resoconto della community sulla persistenza descrive Immich che torna alla procedura iniziale dopo i riavvii perché la directory del database prevista sull’host rimaneva vuota. È un esempio utile del motivo per cui un percorso configurato non dimostra che le scritture lo raggiungano; lo stato osservabile deve sopravvivere all’effettiva operazione del ciclo di vita dichiarata.
Considera superata l’esercitazione solo quando entrambi gli account sono tornati disponibili, l’appartenenza all’album corrisponde, gli hash degli originali coincidono e la ricerca nota si comporta come previsto oppure entra in uno stato di ricostruzione documentato. Qualsiasi ripristino inspiegabile identifica una persistenza mancante. Aggiorna la mappa dello stato prima di affidarti all’automazione del backup costruita sulle stesse ipotesi.
Hub Tecnologico e AI
Altro da leggere

Come gestisce Immich l’autenticazione tra sessioni locali e remote?
Immich utilizza un’identità gestita lato server con sessioni client, mentre gli header del proxy, le origini e i reindirizzamenti OIDC possono far variare il...

Cosa fa rallentare la ricerca o i risultati delle query in Immich con la crescita dei dati?
La crescita di Immich può ingrandire gli indici, espellere le pagine più utilizzate, complicare i filtri e ritardare la distribuzione dei contenuti multimediali; separa...

Perché Immich si comporta diversamente dopo il riavvio di un container?
Dopo il riavvio di Immich, è prevista una perdita temporanea della cache; cambiamenti persistenti nell’accesso, nel database o nei contenuti multimediali indicano problemi di...

