Questa fonte descrive diversi problemi di Immich superficialmente simili, ma non esiste una soluzione universale. L'app Immich visualizzata in grigio dall'autore del post originale è tornata subito a funzionare dopo sudo systemctl restart docker. Un altro utente ha provato lo stesso comando, ma non è comunque riuscito ad avviare Immich. L'errore successivo mostrava che la porta host 2283 era già allocata, un problema diverso da un demone Docker non attivo.
Questa distinzione è la lezione fondamentale: dopo un aggiornamento del sistema operativo, bisogna innanzitutto stabilire se Docker non funziona correttamente, se il problema riguarda un solo progetto Compose oppure se un container obsoleto o duplicato possiede già la porta necessaria a Immich.
Controllare prima lo stato del servizio Docker
La prima raccomandazione di 777-Spider è stata verificare che Docker fosse in esecuzione correttamente. L'autore del post originale ha quindi riavviato Docker e ha riferito che tutto aveva ripreso a funzionare.
Il riavvio di Docker influisce su tutti i container presenti sull'host, quindi va eseguito consapevolmente, tenendo conto che anche le altre applicazioni verranno riavviate.
Il riavvio di Docker non è una soluzione universale per Immich
Chris ha riferito che lo stesso riavvio di Docker aveva aiutato altre app, ma non aveva ripristinato Immich. Questa è una prova diretta del fatto che systemctl restart docker non può essere considerato una soluzione garantita.
Un errore della fonte mostrava esplicitamente che la porta 2283 era già allocata
Per un caso equivalente attuale, bisogna identificare quale container o processo possiede la porta 2283 prima di eliminare o ricreare qualsiasi elemento. Vecchi container Immich duplicati o un progetto Compose ricreato solo parzialmente possono lasciare una porta occupata.
L'errore di avvio dell'app Compose riguarda lo stack applicativo
Se Docker esegue normalmente Paperless o altre app, ma Immich non si avvia con un errore Compose, bisogna esaminare lo stato e i log dei servizi Immich e la definizione Compose attuale, invece di reinstallare l'intero sistema operativo.
La reinstallazione ha aiutato un utente, ma ha richiesto tempo e una nuova copia dei dati
Alla fine Chris ha reinstallato Immich e ricopiato le foto. Ha avvertito esplicitamente della necessità di avere backup. È stata una decisione personale di ultima istanza, non una soluzione confermata per tutti.
Conservare AppData e il database di Immich prima di reinstallare
Lo stato di Immich non consiste solo nella cartella delle foto. Prima di eliminare container o volumi, bisogna conservare il database, la configurazione dell'applicazione e i percorsi delle librerie. ZimaOS attuale conserva i dati importanti delle app al di fuori dei container temporanei.
Utilizzare l'attuale modello di dati persistenti delle app di ZimaOS.
Non considerare questo problema una regressione attuale di Immich 1.7.1
La fonte si riferisce specificamente a ZimaOS 1.5.4 e a una generazione precedente di Immich. ZimaOS attuale e Immich v3 sono versioni molto più recenti, quindi bisogna riprodurre l'errore attuale esatto prima di applicare una soluzione del 2026.
Tornare a una versione precedente di Immich può essere rischioso dopo le migrazioni del database
Un utente della fonte ha dichiarato di essere tornato a una versione precedente di Immich. Gli aggiornamenti a versioni principali possono migrare lo stato del database e dell'applicazione, quindi il supporto al downgrade deve provenire dalle istruzioni della versione Immich corrispondente, non dal semplice ripristino di un tag immagine precedente.
Per risolvere un conflitto di porte bisogna identificare il listener esistente
L'errore della fonte indica esplicitamente che Docker non ha potuto associare la porta host 2283 perché era già allocata. Può accadere quando un vecchio container Immich è ancora in esecuzione, quando un secondo stack utilizza la stessa porta o quando un altro servizio è stato associato a quella porta.
Prima di eliminare qualsiasi elemento, bisogna identificare il container o il listener che sta utilizzando la porta e decidere quale stack debba esserne il proprietario.
Un riquadro dell'app visualizzato in grigio può indicare lo stato di Docker, non la perdita dei dati di Immich
Per l'autore del post originale, il riavvio di Docker ha ripristinato tutte le app. Ciò significa che lo stato grigio di Immich dipendeva dal runtime dei container e non dimostrava che il database delle foto o la libreria fossero stati cancellati.
Un altro partecipante non ha risolto il problema di Immich con lo stesso riavvio, dimostrando perché il solo sintomo nell'interfaccia non sia sufficiente per diagnosticare la causa principale.
Leggere l'errore Compose prima di reinstallare
“Impossibile avviare l'app Compose” è un errore generico. Le informazioni utili si trovano nel messaggio del servizio o del container sottostante: conflitto di porte, volume mancante, errore di salute del database, problema nel recupero dell'immagine, YAML non valido o problema di autorizzazioni.
Conservare i log dell'errore prima di ricreare lo stack; una reinstallazione potrebbe cancellare le prove.
L'attuale Immich v3 rende più rischioso un rollback eseguito alla cieca
Da allora Immich ha introdotto importanti cambiamenti allo schema e alla distribuzione. Un database moderno di v3 potrebbe non essere compatibile con un'immagine precedente scelta arbitrariamente, semplicemente perché nel 2026 un utente aveva eseguito il rollback di una versione v1.x.
Seguire le istruzioni attuali di Immich per la migrazione e il rollback e conservare backup verificati del database e della libreria prima di modificare la versione principale.
Se la reinstallazione è necessaria, conservare prima i percorsi persistenti
Annotare la libreria delle foto, i dati PostgreSQL, la configurazione, i percorsi del machine learning e della cache e le mappature dei volumi attuali. Rimuovere i container temporanei è molto diverso dal cancellare le cartelle persistenti sull'host.
Una reinstallazione pulita eseguita correttamente dovrebbe ricollegarsi ai dati persistenti desiderati o ripristinarli tramite un percorso di backup supportato, senza richiedere di ricopiare da zero l'unica libreria di foto.
Domande frequenti sui problemi di Immich 1.5.4
Il riavvio di Docker ha risolto il problema di Immich dell'autore del post originale?
Sì.
Ha risolto il problema per tutti gli utenti della discussione?
No. Immich di un altro utente continuava a non funzionare e in seguito ha mostrato un conflitto sulla porta 2283.
Gli utenti attuali dovrebbero reinstallare subito Immich?
No. Prima bisogna verificare lo stato del servizio Docker, lo stato di Compose, il proprietario della porta e i dati persistenti.
