La soluzione alternativa della fonte era pratica per un pacchetto Immich del 2025, ma non dovrebbe essere trasformata in una procedura di aggiornamento attuale. Un utente della community ha modificato manualmente immich-server e immich-machine-learning i tag delle immagini a v1.134.0. L'autore originale ha detto che alla fine ha funzionato sul suo sistema ZimaOS principale, ma non su una VM di test.
Da allora Immich è passato alla v3 e il suo modello di distribuzione mantenuto utilizza uno stack Docker Compose completo oltre a un valore IMMICH_VERSION. Aggiornare solo uno o due tag dei servizi può creare uno stack con versioni miste quando cambiano le aspettative relative al database, alla cache, al machine learning o alle API.
La fonte del 2025 ha modificato i singoli tag dei servizi di Immich
La community ha detto all'utente di modificare sia il server sia il machine learning
CogZog ha detto entrambi immich-server e immich-machine-learning dovrebbe usare il nuovo tag. L'utente ha confermato di aver modificato entrambi, ma la VM di test era ancora sulla versione precedente.
La build principale di ZimaOS alla fine ha raggiunto la versione v1.134.0
La fonte non ha stabilito alcuna regola per aggiornare manualmente l'immagine del database
beep ha chiesto se anche il database dovesse essere spostato a un tag più recente e stabile. La risposta della community è stata essenzialmente «se non è rotto, non aggiustarlo». Era un'opinione, non una policy di migrazione di Immich.
L'attuale versione di Immich è la v3, con una procedura completa di aggiornamento di Compose
Immich v3.0.0 è stato rilasciato a luglio 2026. Il progetto upstream indica di aggiornare lo stack mantenuto impostando IMMICH_VERSION=v3 ed eseguire il normale processo Compose di pull e ricreazione, consultando al contempo le note sulle modifiche incompatibili e sulla migrazione della versione v3.
Consulta le indicazioni attuali sulla versione v3 di Immich.
L'upstream attuale raccomanda il bundle Docker Compose completo
La documentazione di installazione attuale di Immich indica agli utenti di scaricare la versione docker-compose.yml e .env, quindi imposta i percorsi e IMMICH_VERSION. Il percorso del database PostgreSQL dovrebbe rimanere su un filesystem locale supportato, anziché su una condivisione di rete.
Usa il modello Compose attuale di Immich per le implementazioni manuali/personalizzate.
Per il pacchetto dell'App Store di ZimaOS, preferisci il percorso di aggiornamento dell'app attuale
L'App Store 2.0 di ZimaOS attualmente include la gestione degli aggiornamenti delle app installate. Se il pacchetto dello store offre un aggiornamento di Immich, lascia che la definizione del pacchetto aggiorni l'intero stack multiservizio invece di modificare manualmente il tag di un singolo servizio.
Esegui un backup prima di un aggiornamento principale di Immich
Proteggi sia la libreria di foto e video sia lo stato del database e dell'applicazione prima di un cambio di versione principale. La sola directory della libreria intatta non basta per ricostruire album, utenti, metadati e stato dell'applicazione.
Evita di creare uno stack Immich con versioni miste
Immich non è un unico container indipendente. L'applicazione, il servizio di machine learning, il database e gli altri componenti di supporto vengono testati come una topologia di rilascio coordinata. Aggiornare un'immagine mentre un'altra rimane bloccata a una versione specifica può causare incompatibilità con le API, lo schema o l'avvio.
La configurazione di origine ha funzionato solo dopo che lo stack effettivo dell'utente era sufficientemente allineato per eseguire la v1.134.0; ciò non dimostra che mescolare tag arbitrari sia sicuro.
Mantieni PostgreSQL su uno storage locale supportato
Gli attuali requisiti di Immich indicano che la directory dei dati PostgreSQL deve usare un file system locale e non deve trovarsi su una condivisione di rete. Lo stato del database è in genere ridotto rispetto alla libreria fotografica, ma è essenziale per utenti, album, metadati e stato dell’applicazione.
Scopri se hai installato il pacchetto ZimaOS o uno stack Compose personalizzato
Se Immich proviene dall’App Store di ZimaOS, usa il percorso di aggiornamento attuale dello store e verifica le modifiche al pacchetto. Se hai importato un tuo Compose, sei responsabile del pinning della versione upstream, .env, il percorso del database e i passaggi per la migrazione.
Mescolare le modifiche dell’App Store con uno stack upstream gestito manualmente rende più difficile la risoluzione dei problemi in futuro.
Esegui i controlli preliminari per un aggiornamento principale
- Conferma di avere un backup recente della libreria fotografica.
- Esegui il backup dello stato del database e dell’applicazione.
- Annota la versione attuale e le mappature dei volumi.
- Leggi le note sulle modifiche incompatibili upstream.
- Assicurati che l’unità di sistema/AppData abbia spazio libero sufficiente per il download delle immagini e le migrazioni.
Verifica la versione in esecuzione e i processi dopo l’aggiornamento
Non fermarti a «Salvataggio completato». Apri la pagina Informazioni/Sistema di Immich, conferma la versione del server in esecuzione, controlla lo stato di salute dei container, quindi verifica i caricamenti, le miniature, i processi di machine learning e la connettività dell’app mobile.
La fonte stessa lo dimostra: modificare il tag non significava immediatamente che l’istanza in esecuzione fosse stata effettivamente aggiornata.
Il rollback non consiste sempre semplicemente nel ripristinare il tag precedente
Una volta che una versione principale ha migrato lo schema o lo stato del database, il downgrade di un’immagine potrebbe non essere supportato. Segui le indicazioni upstream per la migrazione e il rollback e usa i backup, invece di presumere che un tag precedente sia sempre un pulsante universale per annullare l’operazione.
FAQ sull’aggiornamento di Immich
Il metodo di assegnazione manuale dei tag del 2025 ha funzionato sul sistema principale dell’utente della fonte?
Sì, alla fine. La loro macchina virtuale di test non si è comportata allo stesso modo.
Gli utenti attuali di Immich dovrebbero aggiornare solo i tag di immich-server e machine-learning?
No. L’attuale Immich v3 viene mantenuto come uno stack Compose completo, con indicazioni sulla versione e sulla migrazione.
IceWhale ha promesso aggiornamenti automatici di Immich nella fonte?
No. Zima-Giorgio ha solo detto che il team avrebbe discusso la richiesta.
