Perché Immich perde l’accesso ai dati persistenti dopo la ricreazione dello stack?

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.

Quando Immich sembra vuoto o non riesce a leggere la libreria dopo la ricreazione dello stack, supponi che i vecchi dati persistenti siano scollegati o illeggibili, prima di pensare che siano stati eliminati.

La ricreazione dei container può modificare l’identità del progetto Compose, la sorgente del bind mount, l’associazione del volume denominato, la tempistica del mount della condivisione di rete o l’UID/GID usato per leggere i dati. Arresta l’istanza apparentemente nuova prima che scriva molti nuovi dati, individua sull’host i vecchi percorsi del database e dei file multimediali e confronta lo stack ricreato con l’ultima mappatura verificata. L’obiettivo è ricollegare prima i dati esistenti; ripristina da un backup solo dopo aver verificato che quei dati siano davvero mancanti o danneggiati.

Arresta la nuova istanza e verifica che i vecchi dati esistano ancora

Una procedura guidata di configurazione, una timeline vuota o una libreria esterna mancante subito dopo la ricreazione sono segnali di un problema di persistenza. Arresta Immich e controlla sul lato host le posizioni del database e dei file multimediali prima di caricare nuovi file o accettare una nuova configurazione vuota. Le nuove scritture possono rendere più difficili i confronti successivi dei percorsi.

Controlla che le vecchie directory contengano il numero di file previsto, le date di modifica, i file o i dump del database e alcune immagini originali rappresentative. Se i dati sono presenti sull’host, il problema riguarda l’accesso o la mappatura, non la loro scomparsa. Crea uno snapshot o un backup in sola lettura di quei dati prima di modificare i proprietari o spostare le directory.

Se non trovi i vecchi dati nei percorsi previsti, cerca nel pool di archiviazione e nell’inventario dei volumi Docker prima di eliminare qualsiasi cosa. La scelta è binaria: i dati esistenti vengono individuati e protetti oppure sono davvero indisponibili e, invece di riparare i mount, si passa al ripristino da un backup verificato.

Confronta i mount ricreati con quelli dello stack precedente

Controlla i mount effettivi dei container Immich e del database ricreati, non solo il testo Compose che ricordi di aver modificato. Un percorso relativo per un bind mount può essere risolto a partire da una directory di progetto diversa, e un progetto Compose rinominato può collegare un nuovo volume denominato lasciando intatto, ma inutilizzato, quello vecchio.

Un mount non riuscito, modificato o mancante può mostrare una directory vuota all’interno di un container, anche se i dati previsti si trovano ancora altrove sull’host. Usa i controlli dei mount dei volumi Docker per confrontare Source, Destination, tipo di mount e identità del volume con nome per ogni percorso persistente di Immich. Una discrepanza in questo punto spiega direttamente perché l’istanza appare come appena installata.

Correggi solo la mappatura di mount errata, poi crea o avvia il container senza rimuovere i volumi. Se dopo la modifica i file previsti compaiono nello stesso percorso del container, lascia i dati al loro posto. Se l’elenco dei mount è corretto ma l’accesso continua a non riuscire, mantieni la mappatura e verifica la disponibilità dello storage sull’host e le autorizzazioni, invece di creare un altro volume.

Verifica che lo storage esterno fosse montato prima dell’avvio di Immich

Se i dati di Immich si trovano su un pool di HDD, una condivisione NAS, un livello di aggregazione o un altro mount esterno, verifica che lo storage sia effettivamente montato sull’host prima che Docker avvii lo stack. Un percorso come /mnt/photos potrebbe essere ancora presente come normale directory locale anche quando il dispositivo reale è assente.

I dati persistenti di Docker sopravvivono alla sostituzione del container solo se il volume o il bind mount previsto viene ricollegato correttamente. Il modello di persistenza dei volumi Docker sottostante non fa comparire automaticamente un disco host o una condivisione di rete mancante: verifica quindi il dispositivo di storage e un file noto sull’host prima di provare lo stesso percorso in Immich.

Se scopri che, in assenza dello storage reale, sono stati scritti file di fallback nel punto di mount vuoto, arresta Immich prima di montare il dispositivo sopra di essi. Gestisci separatamente questi file, aggiungi una dipendenza all’avvio o un controllo dello stato per il mount dello storage e solo allora riavvia lo stack. Se lo storage dell’host è stabile ma il percorso nel container continua a non essere leggibile, passa alla verifica delle autorizzazioni.

Controlla UID, GID e autorizzazioni delle directory senza riscrivere tutto

Uno stack ricreato può eseguire un servizio con un’identità numerica, uno spazio dei nomi utente o un contesto di sicurezza diversi da quelli precedenti. Il problema è diverso da un mount mancante: il percorso esiste e i file sono visibili dall’host, ma i log di Immich segnalano errori di autorizzazione o l’impossibilità di creare i file previsti.

Confronta i proprietari numerici e i bit di modalità delle directory interessate sull’host con l’identità utente all’interno del container ricreato. Prima prova una lettura innocua, poi una scrittura reversibile in una posizione temporanea sullo stesso mount. Evita di modificare ricorsivamente la proprietà dell’intero archivio fotografico finché non sai quali servizi necessitano dell’accesso in scrittura e quali file originali devono rimanere intatti.

Correggi la minima discrepanza nelle directory o nelle identità che spiega il problema, riavvia una volta e ricontrolla i log. Se l’accesso continua a non funzionare nonostante mount e autorizzazioni corrispondenti, interrompi le modifiche al filesystem e controlla la connessione al database, la sostituzione delle variabili d’ambiente o il livello di sicurezza modificato durante la ricreazione.

Ricollega i dati originali e verifica un’altra ricreazione

Una volta montati i vecchi percorsi del database e dei file multimediali e verificato che siano accessibili in lettura, avvia Immich e controlla che siano presenti i vecchi utenti, album, persone e alcuni file rappresentativi. Non considerare completa la riparazione solo perché si carica la pagina iniziale: verifica che l’applicazione stia leggendo i dati originali e non un database appena inizializzato che si trova accanto a essi.

Il punto fondamentale è che i container possono essere eliminati e ricreati, mentre i dati dell’applicazione devono restare su uno spazio di archiviazione stabile, esterno al ciclo di vita del container. Documenta i nomi corretti dei mount e i percorsi sull’host e usa ruoli di archiviazione persistente del file server per fare in modo che la prossima ricreazione dello stack utilizzi gli stessi dati.

Infine, ricrea ancora una volta lo stack in condizioni controllate e ripeti i controlli originali. La correzione è dimostrata solo se, dopo la ricreazione e il riavvio dell’host, ricompaiono lo stesso database e gli stessi file multimediali. Se i vecchi dati scompaiono di nuovo o il database segnala un danneggiamento anziché errori di accesso, ripristina la copia protetta e passa al recupero del database o del backup invece di continuare a fare prove di montaggio.

Assistenza e consigli

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.