Om Immich-versionen som visas i ZimaOS är äldre än den aktuella Immich-versionen och App Store inte erbjuder någon uppdateringsknapp, finns det sätt att uppdatera containrarna manuellt – men rätt metod beror på vilket Immich-paket för ZimaOS du installerade. IceWhale Community-tråden från december 2025 bekräftade en enkel ändring av bildtaggen för BigBear Immich-paketet, medan senare svar visade att samma knep inte uppdaterade alla andra Immich-paket på ett tillförlitligt sätt.
Communitymetoden var att öppna appens inställningar och endast ändra immich-server och immich-machine-learning bildtaggarna till målversionen, medan databas- och Redis-flikarna lämnades orörda. Trådstartaren bekräftade att uppdateringen gick smidigt, och en annan BigBear-användare gick senare framgångsrikt från v2.3.1 till v2.4.1. Aktuell Immich-dokumentation kräver dock att administratörer läser versionsanteckningarna, säkerhetskopierar databasen och tar hänsyn till ändringar i Compose eller databasen före uppgradering. Manuella taggändringar bör därför inte betraktas som en universell uppdateringsknapp som ”alltid är säker”.
Identifiera först vilket Immich-paket du installerade
Tråden innehåller minst två distributionsvägar:
- BigBear Immich: Flera användare uppgav att redigering av bildtaggarna i ZimaOS utlöste en uppdatering.
- Ursprungligt paket/icke-BigBear-paket: En senare användare uppgav att de fastnade på v2.1.0 även efter att ha försökt ändra server- och maskininlärningsversionerna manuellt.
Öppna Immich-appens inställningar i ZimaOS och notera aktuella bildnamn, taggar, volymmappningar, databasbild och miljövariabler innan du ändrar något. Utgå inte från att instruktioner som skrivits för BigBear-definitionen passar en annan App Store-mall.
BigBear-tagguppdateringen som fungerade i communityn
Den fungerande metoden i communityn var:
- Öppna trepunktsmenyn för Immich-appen på ZimaOS-instrumentpanelen.
- Välj Settings.
- Öppna fliken immich-machine-learning.
- Ändra bildens Tag till önskad Immich-version.
- Öppna fliken immich-server.
- Ange samma release-tagg där.
- Låt databas- och Redis-flikarna vara oförändrade, såvida versionsanteckningarna inte uttryckligen kräver en ändring av databas eller container.
- Spara konfigurationen och låt ZimaOS återskapa eller hämta de berörda containrarna.
Vid tidpunkten för det ursprungliga svaret var exempeltaggen:
v2.3.1Den versionen är historisk. En annan användare uppdaterade senare till v2.4.1, och ett svar från april 2026 nämnde v2.7.4. Kopiera inte någon av de gamla versionsnumren i dag. Välj målversion först efter att ha kontrollerat de aktuella versionsanteckningarna för Immich och din uppgraderingsväg.
Vad trådstartaren bekräftade
Efter att ha fått instruktionerna om BigBear-taggen svarade MikeFrizz att tipset var mycket hjälpsamt och att uppdateringen slutfördes utan problem. Detta är det starkaste bekräftade resultatet i källtråden.
Den bekräftelsen stöder metoden för det paket och den versionskontext som användes av det ursprungliga inläggets författare. Den bevisar inte att manuell redigering av två taggar räcker för varje framtida större Immich-version eller varje ZimaOS-paket.
Anta inte att taggen ”latest” löser problemet
En användare ändrade taggen till latest, men ZimaOS återgick upprepade gånger till den tidigare installerade versionen. Tråden innehåller sedan gissningar, som att prova versionen, men det finns ingen källverifierad universell lösning som bygger på dessa generiska taggnamn.
Den aktuella Immich-dokumentationen använder en uttrycklig versionsvariabel och stöder metataggar för större versioner i sitt eget Docker Compose-arbetsflöde. För en paketerad ZimaOS-app ska du använda det taggformat som paketdefinitionen och uppströmsavbilden faktiskt stöder. Undvik att hitta på taggar bara för att en etikett låter rimlig.
Säkerhetskopiera Immich innan du ändrar version
Den aktuella Immich-dokumentationen rekommenderar uttryckligen att databasen säkerhetskopieras före uppgraderingar som kan innebära migreringar. Dina foton och videor behöver också en separat säkerhetskopieringsstrategi; en säkerhetskopia av databasen ersätter inte själva mediebiblioteket.
Använd den aktuella guiden för säkerhetskopiering och återställning av Immich före ett manuellt versionssteg.
Bevara åtminstone:
- säkerhetskopian av Immich-databasen;
- mediebiblioteket/uppladdningsdata;
- den aktuella appkonfigurationen och volymmappningarna i ZimaOS;
- de aktuella avbildstaggarna;
- samt eventuella miljövariabler eller anpassade lagringsplatser.
Läs Immichs versionsinformation före varje versionssteg
Den aktuella uppgraderingsdokumentationen för Immich säger att administratörer bör kontrollera versionsinformationen för brytande ändringar innan uppdatering. Den normala Docker Compose-processen uppströms är:
docker compose pull && docker compose up -dmen först efter att Compose-definitionen och versionsvariablerna är lämpliga för målversionen.
Se den aktuella uppgraderingsguiden för Immich.
Detta är viktigt för ZimaOS eftersom en paketerad app kan ligga efter inte bara när det gäller avbildstaggar, utan även när det gäller dess Compose-motsvarighet. En nyare immich-server avbilden kan kräva ändringar i databasen, miljön, hälsokontroller eller volymer som ett äldre paket inte innehåller.
Håll Immich-servern och maskininlärningsversionerna kompatibla
Communityn ändrade specifikt taggarna för båda immich-server och immich-machine-learning. Den aktuella Immich-dokumentationen varnar också för att versionsskillnader mellan huvudservern och maskininlärningskomponenterna kan orsaka fel eller instabilitet.
Uppdatera inte bara den ena av de två för att den råkade visa en tillgänglig avbild först. Behandla dem som en samordnad programversion, såvida den aktuella versionsdokumentationen inte uttryckligen säger något annat.
Ändra inte databascontainerns tagg på måfå
Communityts råd att lämna databasfliken orörd var rimligt för de exakta mindre BigBear-uppdateringar som diskuterades där. Immichs PostgreSQL-lager har egna migreringar och har förändrats över tid, bland annat genom migreringen från äldre vektortillägg till VectorChord.
- Höj inte databasavbildningens tagg enbart för att få alla taggar att se numeriskt lika ut.
- Utgå inte från att databasavbildningen aldrig får ändras; om Immichs aktuella versionsanteckningar kräver en databas-/Compose-migrering ska du följa den dokumenterade migreringen i stället.
Vad händer om den ursprungliga Immich-appen i ZimaOS blir kvar på en gammal version?
Ett svar från mars 2026 sade att användaren inte körde versionen från BigBears App Store och fortfarande var fast på Immich v2.1.0, även efter att manuellt ha försökt uppdatera avbildningarna för maskininlärning och servern. Tråden innehåller ingen bekräftad lösning för den användarens ursprungliga paketdistribution.
Detta är en viktig gränsdragning: om en manuell ändring av avbildningstaggarna inte uppdaterar appen ska du sluta upprepa samma åtgärd. Jämför paketets aktuella containerdefinition med Immichs aktuella Compose-krav och överväg att migrera till ett underhållet ZimaOS-paket först efter att du har säkerhetskopierat och bekräftat datasökvägarna.
Avinstallera inte ett fungerande Immich-paket innan du vet var dess databas- och medievolymer lagras.
Varför användare i communityt föreslog BigBears Immich-paket
Det första svaret rekommenderade BigBears Immich-app eftersom den vanligtvis hölls närmare upstream-versionerna. De senare framgångsrika instruktionerna för att redigera taggar testades också uttryckligen på BigBear.
Detta gör inte ”installera om BigBear” till en säker migreringsväg med ett klick för ett befintligt bibliotek. Ett nytt paket kan använda andra volymnamn, datakataloger, databasavbildningar eller miljövariabler. Behandla paketmigrering som en separat åtgärd från uppgradering av en befintlig stack.
Var försiktig med automatiska uppdaterare av containrar
Ett communitysvar från april 2026 föreslog Tugtainer som ett enklare alternativ till Watchtower för att kontrollera och automatiskt uppdatera containrar. Det förslaget kan vara praktiskt för tillståndslösa tjänster, men Immich är en tillståndsbevarande applikation med flera containrar, en PostgreSQL-databas och dokumenterade uppgraderingsvägar för inkompatibla ändringar.
För Immich kan det vara riskabelt att automatiskt ersätta avbildningar utan att läsa versionsanteckningarna. Den aktuella Immich-dokumentationen uppmanar uttryckligen administratörer att ta hänsyn till inkompatibla ändringar före uppgraderingar. Om du över huvud taget använder en automatisk uppdaterare av containrar bör du för Immich föredra aviseringar eller manuellt godkännande i stället för att blint uppdatera varje ny tagg.
Säkrare arbetsflöde för uppdatering av Immich i ZimaOS
- Anteckna om det installerade paketet är BigBear eller en annan Immich-definition.
- Anteckna de aktuella avbildningarna och taggarna för servern, maskininlärningen, databasen och Redis.
- Säkerhetskopiera Immich-databasen och viktiga medier.
- Läs versionsinformationen uppströms för varje gräns med brytande ändringar mellan din aktuella version och målversionen.
- Bekräfta om målversionen kräver ändringar i Compose, databasen, miljövariablerna eller lagringen.
- För en kompatibel BigBear-mindre uppdatering ändrar du server- och maskininlärningstaggarna tillsammans, precis som communityn gjorde.
- Låt databas- och Redis-avbildningarna vara oförändrade om den dokumenterade uppgraderingssökvägen inte uttryckligen kräver en ändring.
- Spara appinställningarna och följ containerloggarna medan de nya avbildningarna startar.
- Verifiera Immichs version i webbgränssnittet, uppladdningar, miniatyrbilder, maskininlärning och det befintliga biblioteket innan du tar bort gamla avbildningar.
- Om paketet omedelbart rullar tillbaka eller förblir på den gamla versionen bör du granska paketdefinitionen i stället för att upprepade gånger tvinga fram taggar.
Vad du bör verifiera efter en Immich-uppdatering
- Webbgränssnittet laddas och visar den avsedda serverversionen.
- Mobilappen kan ansluta och är kompatibel med serverns huvudversion.
- Befintliga foton och videor öppnas korrekt.
- Nya uppladdningar slutförs utan problem.
- Jobb för miniatyrbilder och omkodning körs.
- Maskininlärningsfunktionerna startar utan fel om versionsmatchning.
- PostgreSQL-containern förblir frisk.
Immichs aktuella dokumentation anger att nedgradering inte är en stödd återställningsstrategi. En säkerhetskopia är säkrare än att anta att du bara kan ändra tillbaka taggen efter en datasmigrering.
Vanliga frågor om uppdatering av Immich i ZimaOS
Kan jag uppdatera Immich genom att ändra avbildningstaggarna i ZimaOS?
Ja, för vissa kombinationer av paket och versioner. Den ursprungliga skribenten och en annan BigBear-användare bekräftade att det fungerade att ändra både server- och maskininlärningstaggarna. Tråden innehåller också en användare som inte använder BigBear, där metoden inte löste den föråldrade installationen.
Vilka Immich-taggar ska jag ändra?
I den bekräftade BigBear-metoden från communityn är immich-server och immich-machine-learning taggarna ändrades tillsammans. Kopiera inte de gamla exemplen v2.3.1, v2.4.1 eller v2.7.4 som aktuella målversioner.
Bör jag använda latest?
Inte som en universallösning. En användare i tråden rapporterade att latest fastnade inte. Använd det versionsschema som stöds av ditt faktiska paket och den aktuella Immich-dokumentationen.
Kan jag bara köra docker pull?
Att bara hämta en ny avbildning återskapar inte den körande containern och tillämpar inte Compose-ändringar. Immich uppströms använder docker compose pull && docker compose up -d efter att konfigurationen har förberetts för målversionen.
Bör Tugtainer eller Watchtower automatiskt uppdatera Immich?
Automatiska uppdateringar kan hoppa över granskningen av versionsinformationen och migreringarna som Immich uttryckligen rekommenderar. För en tillståndsbaserad applikation med en databas är avisering och kontrollerade manuella uppgraderingar säkrare än blind automatisk ersättning.
Behöver jag en säkerhetskopia före en Immich-uppdatering?
Ja. Immichs aktuella dokumentation om uppgraderingar och säkerhetskopiering rekommenderar att databasen skyddas före uppgraderingar, och oersättliga medier bör säkerhetskopieras separat.
