Se la versione di Immich mostrata in ZimaOS è precedente a quella della release upstream di Immich e l’App Store non offre un pulsante Aggiorna, è possibile aggiornare manualmente i container, ma il metodo corretto dipende dal pacchetto Immich di ZimaOS installato. La discussione della IceWhale Community del dicembre 2025 ha confermato una semplice modifica del tag dell’immagine per il pacchetto Immich BigBear, mentre risposte successive hanno mostrato che lo stesso metodo non aggiornava in modo affidabile tutti gli altri pacchetti Immich.
Il metodo della community consisteva nell’aprire le impostazioni dell’app e modificare solo i immich-server e immich-machine-learning i tag delle immagini alla versione di destinazione, lasciando invariate le schede del database e di Redis. L’autore del post originale ha confermato che l’aggiornamento è andato a buon fine, e in seguito un altro utente BigBear è passato correttamente dalla v2.3.1 alla v2.4.1. Tuttavia, la documentazione attuale di Immich richiede agli amministratori di leggere le note di rilascio, eseguire il backup del database e tenere conto delle modifiche a Compose/al database prima dell’aggiornamento. Pertanto, la modifica manuale dei tag non deve essere considerata un pulsante universale di aggiornamento “sempre sicuro”.
Identifica innanzitutto quale pacchetto Immich hai installato
La discussione contiene almeno due percorsi di distribuzione:
- Immich BigBear: diversi utenti hanno riferito che la modifica dei tag delle immagini in ZimaOS ha attivato correttamente un aggiornamento.
- Pacchetto originale/non BigBear: un utente successivo ha riferito di essere rimasto bloccato alla v2.1.0 anche dopo aver provato a modificare manualmente le versioni del server e del machine learning.
Apri le impostazioni dell’app Immich in ZimaOS e annota i nomi attuali delle immagini, i tag, le mappature dei volumi, l’immagine del database e le variabili d’ambiente prima di modificare qualsiasi cosa. Non presumere che le istruzioni scritte per la definizione BigBear corrispondano a un altro modello dell’App Store.
L’aggiornamento del tag BigBear che ha funzionato nella community
La procedura della community che ha funzionato è stata:
- Nella dashboard di ZimaOS, apri il menu con i tre puntini dell’app Immich.
- Seleziona Impostazioni.
- Apri la scheda immich-machine-learning.
- Modifica il Tag dell’immagine impostandolo sulla versione di Immich desiderata.
- Apri la scheda immich-server.
- Imposta lì lo stesso tag di versione.
- Lascia invariate le schede del database e di Redis, a meno che le note di rilascio non richiedano esplicitamente una modifica al database o al container.
- Salva la configurazione e lascia che ZimaOS ricrei/recuperi i container interessati.
Al momento della risposta originale, il tag di esempio era:
v2.3.1Quella versione è storica. In seguito, un altro utente ha aggiornato a v2.4.1, e una risposta dell’aprile 2026 menzionava v2.7.4. Non copiare oggi nessuno di quei vecchi numeri di versione. Scegli la versione di destinazione solo dopo aver controllato le note di rilascio attuali di Immich e il tuo percorso di aggiornamento.
Cosa ha confermato l’autore del post originale
Dopo aver ricevuto le istruzioni sui tag di BigBear, MikeFrizz ha risposto che il suggerimento era molto utile e che l’aggiornamento si era completato senza problemi. Questo è il risultato confermato più solido nella discussione originale.
Quella conferma supporta il metodo per il pacchetto e il contesto di versione utilizzati dall’autore originale. Non dimostra che modificare manualmente due tag sia sufficiente per ogni futura versione principale di Immich o per ogni pacchetto ZimaOS.
Non dare per scontato che il tag “latest” risolva il problema
Un utente ha modificato il tag in latest, ma ZimaOS tornava ripetutamente alla versione precedentemente installata. La discussione contiene poi ipotesi come provare release, ma non esiste una soluzione universale confermata dalle fonti basata su quei nomi generici dei tag.
La documentazione corrente di Immich utilizza una variabile di versione esplicita e supporta i metatag delle versioni principali nel proprio flusso di lavoro Docker Compose. Per un’app ZimaOS pacchettizzata, usa il formato dei tag effettivamente supportato dalla definizione del pacchetto e dall’immagine upstream. Evita di inventare tag solo perché un’etichetta sembra plausibile.
Esegui il backup di Immich prima di cambiare versione
La documentazione corrente di Immich raccomanda esplicitamente di eseguire il backup del database prima degli aggiornamenti che possono comportare migrazioni. Anche le foto e i video richiedono una strategia di backup indipendente; un backup del database non sostituisce la libreria multimediale.
Prima di eseguire manualmente un salto di versione, usa la guida al backup e al ripristino di Immich.
Come minimo, conserva:
- il backup del database di Immich;
- i dati della libreria multimediale e dei caricamenti;
- la configurazione dell’app ZimaOS corrente e le mappature dei volumi;
- i tag delle immagini correnti;
- e tutte le variabili d’ambiente o i percorsi di archiviazione personalizzati.
Leggi le note di rilascio di Immich prima di ogni salto di versione
La documentazione corrente sull’upgrade di Immich indica che gli amministratori devono consultare le note di rilascio per verificare la presenza di modifiche incompatibili prima dell’aggiornamento. La normale procedura Docker Compose upstream è:
docker compose pull && docker compose up -dma solo dopo aver verificato che la definizione Compose e le variabili di versione siano appropriate per la release di destinazione.
Consulta la guida aggiornata all’upgrade di Immich.
Questo è importante per ZimaOS, perché un’app pacchettizzata può essere in ritardo non solo nei tag delle immagini, ma anche nella relativa definizione equivalente a Compose. Una versione più recente immich-server l’immagine potrebbe richiedere modifiche al database, all’ambiente, ai controlli dello stato o ai volumi che un pacchetto precedente non contiene.
Mantieni compatibili le versioni del server Immich e del componente di machine learning
La community ha modificato specificamente i tag per entrambi immich-server e immich-machine-learningAnche la documentazione corrente di Immich avverte che le incompatibilità di versione tra il server principale e i componenti di machine learning possono causare bug o instabilità.
Non aggiornarne solo uno perché per caso ha mostrato per primo un’immagine disponibile. Considerali come un’unica versione applicativa coordinata, salvo che la documentazione della release corrente indichi esplicitamente il contrario.
Non modificare casualmente il tag del container del database
Il consiglio della community di lasciare invariata la scheda del database era sensato per gli esatti aggiornamenti minori di BigBear discussi lì. Il livello PostgreSQL di Immich ha migrazioni proprie ed è cambiato nel tempo, inclusa la migrazione dalle estensioni vettoriali precedenti a VectorChord.
- Non aggiornare l'immagine del database solo per fare in modo che tutti i tag abbiano numeri simili.
- Non presumere che l'immagine del database non debba mai cambiare; se le note di rilascio attuali di Immich richiedono una migrazione del database o di Compose, segui invece la procedura di migrazione documentata.
Cosa fare se l'app Immich originale di ZimaOS rimane a una versione obsoleta?
Una risposta del marzo 2026 affermava che l'utente non stava eseguendo la versione dell'App Store BigBear ed era rimasto bloccato su Immich v2.1.0 anche dopo aver provato manualmente ad aggiornare le immagini del machine learning e del server. La discussione non contiene una risoluzione confermata per la distribuzione del pacchetto originale di quell'utente.
Questo è un limite importante: se la modifica manuale dei tag delle immagini non aggiorna l'app, interrompi la ripetizione della stessa operazione. Confronta la definizione attuale dei container del pacchetto con i requisiti Compose attuali di Immich e valuta la migrazione a un pacchetto ZimaOS mantenuto attivamente solo dopo aver eseguito il backup e confermato i percorsi dei dati.
Non disinstallare un pacchetto Immich funzionante prima di sapere dove sono archiviati i volumi del database e dei file multimediali.
Perché gli utenti della community suggerivano il pacchetto Immich di BigBear
La prima risposta consigliava l'app Immich di BigBear perché di solito veniva mantenuta più vicina alle versioni upstream. Anche le istruzioni successive, che avevano funzionato per modificare i tag, erano state testate esplicitamente su BigBear.
Questo non rende “reinstallare BigBear” un percorso sicuro con un solo clic per migrare una libreria esistente. Un pacchetto appena installato può usare nomi di volumi, directory dei dati, immagini del database o variabili d'ambiente differenti. Considera la migrazione del pacchetto un'operazione separata dall'aggiornamento di uno stack esistente.
Fai attenzione agli aggiornamenti automatici dei container
Una risposta della community dell'aprile 2026 suggeriva Tugtainer come alternativa più semplice a Watchtower per controllare e aggiornare automaticamente i container. Il suggerimento può essere comodo per i servizi senza stato, ma Immich è un'applicazione con più container e stato persistente, dotata di un database PostgreSQL e di procedure documentate per gli aggiornamenti con modifiche incompatibili.
Per Immich, sostituire automaticamente le immagini senza leggere le note di rilascio può essere rischioso. La documentazione attuale di Immich indica esplicitamente agli amministratori di tenere conto delle modifiche incompatibili prima degli aggiornamenti. Se utilizzi comunque un aggiornamento automatico dei container, per Immich preferisci le notifiche o l'approvazione manuale invece di aggiornare ciecamente ogni nuovo tag.
Flusso di lavoro più sicuro per l'aggiornamento di Immich su ZimaOS
- Annota se il pacchetto installato è BigBear o un'altra definizione di Immich.
- Annota le immagini e i tag attuali del server, del machine learning, del database e di Redis.
- Esegui il backup del database di Immich e dei file multimediali importanti.
- Leggi le note di rilascio a monte per ogni punto di passaggio con modifiche incompatibili tra la versione attuale e quella di destinazione.
- Conferma se la versione di destinazione richiede modifiche a Compose, al database, alle variabili d'ambiente o allo storage.
- Per un aggiornamento minor compatibile di BigBear, modifica insieme i tag del server e del machine learning, come ha fatto la community.
- Lascia invariate le immagini di database e Redis, a meno che il percorso di aggiornamento documentato non richieda specificamente una modifica.
- Salva le impostazioni dell'app e osserva i log dei container mentre vengono avviate le nuove immagini.
- Verifica la versione nell'interfaccia web di Immich, i caricamenti, le miniature, il machine learning e la libreria esistente prima di eliminare le vecchie immagini.
- Se il pacchetto esegue immediatamente il rollback o rimane sulla vecchia versione, controlla la definizione del pacchetto invece di forzare ripetutamente i tag.
Cosa verificare dopo un aggiornamento di Immich
- L'interfaccia web si carica e mostra la versione del server prevista.
- L'app mobile riesce a connettersi ed è compatibile con la versione principale del server.
- Le foto e i video esistenti si aprono correttamente.
- I nuovi caricamenti vengono completati correttamente.
- I processi di generazione delle miniature e transcodifica vengono eseguiti.
- Le funzionalità di machine learning si avviano senza errori di incompatibilità di versione.
- Il container PostgreSQL rimane integro.
La documentazione attuale di Immich segnala che il downgrade non è una strategia di ripristino supportata. Un backup è più sicuro che presumere di poter semplicemente riportare indietro il tag dopo una migrazione del database.
Domande frequenti sull'aggiornamento di Immich su ZimaOS
Posso aggiornare Immich modificando i tag delle immagini di ZimaOS?
Sì, per alcune combinazioni di pacchetto e versione. L'autore del post originale e un altro utente di BigBear hanno confermato che modificare entrambi i tag, del server e del machine learning, ha funzionato. La discussione contiene anche un utente non BigBear per il quale il metodo non ha risolto il problema dell'installazione obsoleta.
Quali tag di Immich devo modificare?
Nel metodo della community BigBear confermato, immich-server e immich-machine-learning i tag sono stati modificati insieme. Non copiare gli esempi precedenti v2.3.1, v2.4.1 o v2.7.4 come versioni di destinazione attuali.
Devo usare latest?
Non come soluzione universale. Un utente nella discussione ha riferito che latest non è rimasto valido. Usa lo schema di versionamento supportato dal tuo pacchetto effettivo e dalle indicazioni attuali di Immich.
Posso semplicemente eseguire docker pull?
Il semplice download di una nuova immagine non ricrea il container in esecuzione né applica le modifiche di Compose. Immich a monte utilizza docker compose pull && docker compose up -d dopo aver preparato la configurazione per la versione di destinazione.
Tugtainer o Watchtower devono aggiornare automaticamente Immich?
Gli aggiornamenti automatici possono saltare la revisione delle note di rilascio e delle migrazioni raccomandata esplicitamente da Immich. Per un'applicazione con stato e un database, le notifiche e gli aggiornamenti manuali controllati sono più sicuri della sostituzione automatica alla cieca.
Ho bisogno di un backup prima di un aggiornamento di Immich?
Sì. La documentazione attuale di Immich sugli aggiornamenti e i backup raccomanda di proteggere il database prima degli aggiornamenti e di proteggere separatamente i contenuti multimediali insostituibili.
