Se Immich su ZimaOS rimane a una versione precedente dopo aver modificato solo il tag dell’immagine di immich-server, smetti di modificare un container alla volta e identifica prima il pacchetto o lo stack. Immich è un’applicazione composta da più servizi; il server, il machine learning, il database e i componenti della cache devono rimanere compatibili, e alcuni pacchetti ZimaOS sono gestiti da fonti diverse dell’app store.
La discussione originale mostra perché un aggiornamento di un solo campo può non riuscire: l’utente ha modificato l’immagine del server, ha osservato attività di download dalla rete, ha riavviato il sistema e Immich continuava a riportare la versione v2.6.1. Un altro utente ha mostrato una configurazione funzionante con v3.1.0 e immagini dei servizi corrispondenti. La guida corretta è quindi “esegui il backup, identifica lo stack, aggiorna in modo coerente, verifica”, non “inserisci un numero più recente in un solo campo”.
Passaggio 1: identifica quale pacchetto Immich hai installato
ZimaOS può avere pacchetti ufficiali e pacchetti di store di terze parti o della community. Apri le impostazioni dell’app e annota ogni immagine dei servizi, non solo immich-server.
Annota anche la fonte dell’app store, così saprai chi controlla i metadati degli aggiornamenti.
Passaggio 2: esegui il backup di Immich prima di qualsiasi aggiornamento importante
Esegui il backup della libreria fotografica e del database PostgreSQL. L’attuale guida al backup e al ripristino di Immich documenta una procedura per il dump del database.
Non considerare la ricreazione di un container come un backup.
Passaggio 3: controlla le versioni di tutti i servizi
Il confronto delle fonti riportava:
- Server Immich;
- Machine learning di Immich;
- Postgres;
- Valkey/Redis.
Annota i tag completi delle immagini. Se l’app store li gestisce come un bundle testato, preferisci la sua azione Aggiorna invece di portare manualmente un componente avanti rispetto agli altri.
Passaggio 4: usa l’aggiornamento dell’App Store quando disponibile
La documentazione attuale di ZimaOS indica che l’ultimo pacchetto Immich può essere installato dall’App Store. Se è disponibile un pulsante di aggiornamento, usalo affinché anche la definizione Compose del manutentore del pacchetto venga aggiornata.
L'attuale guida di ZimaOS per Immich è l'attuale punto di partenza ufficiale per ZimaOS.
Perché la modifica di un singolo tag può sembrare effettuare il download senza aggiornare
Il gestore delle app potrebbe scaricare una nuova immagine, ma ricreare il servizio utilizzando i metadati del marketplace, un altro valore YAML salvato o una definizione di immagine diversa. Il container in esecuzione potrebbe quindi tornare al vecchio tag.
Controlla l'immagine effettivamente in esecuzione con:
docker ps --format '{.Names} {.Image}'Non saltare alla cieca tra le versioni principali di Immich
Le release di Immich possono includere modifiche al database/schema e ai servizi. Leggi le note upstream sulla release e sull'aggiornamento per le versioni che stai attraversando. Aggiorna lo stack come un'unità, invece di indovinare combinazioni compatibili.
Se utilizzi un pacchetto BigBear o di terze parti
Una guida separata della community di ZimaSpace documenta che la modifica dei tag delle immagini ha funzionato per alcuni pacchetti BigBear, mentre in seguito altri utenti hanno riscontrato che lo stesso metodo non era universale per tutti i pacchetti. Identifica la sorgente del pacchetto prima di applicare questa soluzione alternativa.
La guida all'aggiornamento di Immich spiega questo limite specifico del pacchetto.
Verifica l'aggiornamento dopo aver ricreato lo stack
Controlla tre elementi:
- i tag delle immagini Docker in esecuzione;
- la visualizzazione della versione del server di Immich;
- i log del container per individuare errori di migrazione o compatibilità.
Non eliminare il database o la cartella degli upload per forzare un aggiornamento
La rimozione dei volumi è un ripristino distruttivo, non un metodo di aggiornamento. Conserva il database e la libreria fotografica, a meno che tu non disponga di un backup testato e non voglia intenzionalmente una nuova installazione.
Domande frequenti
Perché Immich mostra ancora 2.6.1 dopo aver modificato il tag del server?
L'app potrebbe ricreare la vecchia definizione del servizio oppure lo stack potrebbe non essere stato aggiornato in modo coerente. Controlla l'immagine effettivamente in esecuzione e la sorgente del pacchetto.
La versione di machine learning deve corrispondere esattamente a quella del server?
Segui le versioni testate nella definizione di release/Compose di Immich che stai distribuendo. Non inventare tag indipendenti per ogni servizio.
Posso aggiornare solo immich-server?
Evitalo come impostazione predefinita. Immich è uno stack multi-servizio e gli aggiornamenti possono richiedere modifiche coordinate.
Di cosa dovrei fare il backup per prima cosa?
Il database PostgreSQL e lo spazio di archiviazione per contenuti multimediali/upload. Verifica il backup prima di apportare modifiche importanti alla versione.
