Soluzione della community

L’interfaccia web di Immich si blocca su ZimaOS: aggiorna prima di reinstallare

Several users reported an Immich 2.2.x browser freeze while mobile access still worked; a participant later confirmed recovery after updating Immich through ZimaOS.

Separare l’interfaccia web di Immich dal server e dall’app mobile

Il sintomo iniziale non era un semplice arresto del container. Immich si apriva nel browser, mostrava la navigazione, non riusciva a caricare la libreria fotografica e poteva bloccare sia le schede di Immich sia quelle di ZimaOS.

Più utenti hanno segnalato che l’app Android continuava a funzionare mentre Chrome, Firefox o altri browser non funzionavano. Un autore ha anche testato Firefox senza una cronologia precedente di Immich, quindi la cache non spiegava ogni caso.

Confronta una sessione pulita del browser con l’app mobile e verifica se le foto restano accessibili. Il funzionamento su dispositivi mobili insieme al mancato funzionamento del browser restringe l’analisi al percorso web o al frontend incluso nel pacchetto; un errore su ogni client richiede un controllo più ampio del server, del database, dell’archiviazione e delle risorse.

Interfaccia web di Immich che mostra la navigazione senza una libreria fotografica caricata
Il browser visualizzava i controlli, ma non caricava i contenuti della libreria.

Proteggere separatamente i file multimediali e lo stato del database

Prima di disinstallare l’app o modificare i volumi, verifica dove Immich memorizza gli elementi caricati o la libreria esterna. Copia le foto e i video importanti su un altro disco, NAS o computer e apri alcuni file dalla copia.

Album, utenti e altri metadati dipendono dal database, quindi una cartella di file immagine non costituisce un backup completo dell’applicazione. Conserva un dump utilizzabile del database insieme ai file multimediali e annota le mappature dei volumi attuali e la versione di Immich.

Non eliminare la directory di archiviazione delle foto durante la rimozione dell’app. Se manca la copia dei file multimediali o l’input necessario per il ripristino del database, fermati prima di reinstallare e completa innanzitutto la copertura dei backup.

Escludere la pressione sulle risorse senza presumere che sia la causa

I processi di apprendimento automatico di Immich possono utilizzare molta CPU e memoria durante l’elaborazione iniziale. Una risposta della community ha suggerito di disabilitare temporaneamente l’apprendimento automatico e verificare se l’interfaccia si stabilizza.

Altri partecipanti avevano già completato le attività di apprendimento automatico, disponevano di hardware adeguato o riuscivano ancora a sfogliare i contenuti da dispositivi mobili. Pertanto, la discussione non dimostra che l’apprendimento automatico abbia causato il sintomo comune del blocco nel browser.

Se il carico del sistema è elevato, metti in pausa un’attività e riprova la stessa vista della libreria. Un miglioramento supporta l’ipotesi di un problema di risorse; nessun cambiamento significa che puoi ripristinare l’impostazione prevista e proseguire, invece di lasciare disabilitate funzioni senza alcun beneficio.

Applicare l’aggiornamento disponibile di ZimaOS o Immich prima di reinstallare

Diverse segnalazioni si sono concentrate su Immich 2.2.x, inclusa quella di un utente che ha riferito che la versione 2.2.1 funzionava prima di un aggiornamento. Un altro partecipante ha segnalato un’installazione stabile della versione 2.1.0 e ha proposto un ripristino a una versione precedente, ma la discussione non documenta un ripristino completato come controllo.

Il ripristino confermato è arrivato da un utente che ha atteso l’aggiornamento del container e ha poi aggiornato Immich tramite ZimaOS. L’interfaccia web è tornata a funzionare senza reinstallare l’app o ripristinare i dati.

Dopo l’aggiornamento, riapri lo stesso album nel browser, scorri la libreria, apri un elemento e ripeti la verifica dopo aver riavviato l’app. Continua a monitorare l’accesso da dispositivi mobili e i caricamenti, così il successo non viene valutato sulla base del caricamento di una sola pagina.

Informazioni sulla versione di Immich discusse durante il blocco del browser su ZimaOS
La discussione ha confrontato il comportamento delle versioni senza dimostrare un guasto hardware.

Reinstallare solo dopo aver verificato il percorso di aggiornamento e i backup

Un utente ha disinstallato e reinstallato l’app utilizzando una libreria esterna, ma ha continuato a riscontrare il problema. La reinstallazione non è quindi stata la soluzione confermata dalla fonte e non dovrebbe essere il primo passaggio.

Se un aggiornamento non risolve il problema, esamina i log e conserva la versione esatta in cui si verifica l’errore. Reinstalla solo dopo aver verificato i file multimediali, il backup del database, le mappature dei volumi e le istruzioni di ripristino compatibili con la versione.

Il ripristino è completo quando album, utenti, elementi, backup da dispositivi mobili e libreria del browser funzionano tutti con il carico di lavoro originale. Se mancano metadati o il servizio continua a bloccarsi, interrompi la procedura e ripristina lo stato precedente invece di eliminare ripetutamente i container.

Domande frequenti

Posso reinstallare Immich senza perdere le foto?

Solo se conservi la directory di archiviazione, ma proteggere esclusivamente le foto non preserva tutti gli album e i metadati. Conserva anche un backup recuperabile del database.

Perché Immich funziona sui dispositivi mobili ma si blocca nel browser?

Questo schema restringe il percorso in cui cercare il problema, ma la discussione non dimostra un’unica causa universale legata al browser. Il ripristino confermato dall’utente è avvenuto tramite un aggiornamento del pacchetto.

Devo eseguire il downgrade di Immich alla versione 2.1.0?

Un partecipante ha riferito che la versione 2.1.0 funzionava, ma la discussione non documenta un ripristino a una versione precedente completato con successo. Prova prima l’aggiornamento supportato disponibile e conserva i dati necessari al ripristino.