Källans lösning var praktisk för ett Immich-paket från 2025, men bör inte låsas fast i en aktuell uppgraderingsguide. En användare i gemenskapen ändrade manuellt immich-server och immich-machine-learning avbildningstaggar till v1.134.0. Det ursprungliga inläggets författare sa att det till slut fungerade på deras primära ZimaOS-system, men inte på en test-VM.
Immich har sedan dess gått över till v3, och den underhållna distributionsmodellen använder en komplett Docker Compose-stack samt värdet IMMICH_VERSION. Om bara en eller två tjänstetaggar uppdateras kan en stack med blandade versioner skapas när antaganden om databas, cache, maskininlärning eller API har ändrats.
Källan från 2025 redigerade taggarna för enskilda Immich-tjänster
Gemenskapen sa åt användaren att ändra både servern och maskininlärningen
CogZog sa båda immich-server och immich-machine-learning bör använda den nya taggen. Användaren bekräftade att de hade ändrat båda, men test-VM:n låg fortfarande kvar på den äldre versionen.
Den primära ZimaOS-versionen nådde till slut v1.134.0
Källan fastställde ingen regel om att manuellt uppdatera databasavbildningen
beep frågade om databasen också borde flyttas till en nyare/stabil tagg. Gemenskapens svar var i princip ”om det inte är trasigt, laga det inte”. Det var en åsikt, inte en migreringspolicy för Immich.
Den aktuella Immich-versionen är v3, med en komplett Compose-uppdateringssökväg
Immich v3.0.0 släpptes i juli 2026. Uppströmsprojektet säger att den underhållna stacken ska uppdateras genom att ange IMMICH_VERSION=v3 och köra den normala Compose-processen för hämtning och återskapande, samtidigt som du granskar anteckningarna om brytande ändringar och migrering för v3.
Se den aktuella vägledningen för Immich v3.
Uppströmsprojektet rekommenderar nu hela Docker Compose-paketet
Immichs aktuella installationsdokumentation instruerar användare att ladda ned releasens docker-compose.yml och .env, ange sedan platserna och IMMICH_VERSION. PostgreSQL-databassökvägen bör förbli på ett lokalt filsystem som stöds, inte på en nätverksresurs.
Använd den aktuella Immich Compose-modellen för manuella/anpassade distributioner.
För ZimaOS App Store-paketet: föredra den aktuella vägen för appuppdatering
Den aktuella ZimaOS App Store 2.0 innehåller hantering av uppdateringar för installerade appar. Om butikspaketet erbjuder en Immich-uppdatering bör du låta paketdefinitionen uppdatera hela stacken med flera tjänster i stället för att självständigt redigera en enskild tjänstetagg.
Säkerhetskopiera innan en större Immich-uppgradering
Skydda både foto-/videobiblioteket och databasens/applikationens tillstånd före en större versionsändring. En fungerande bibliotekskatalog räcker inte ensam för att återskapa album, användare, metadata och applikationens tillstånd.
Undvik att skapa en Immich-stack med blandade versioner
Immich är inte en enda fristående container. Applikationen, maskininlärningstjänsten, databasen och andra stödkomponenter testas som en samordnad release-topologi. Om en image uppdateras medan en annan förblir låst till en viss version kan det leda till inkompatibilitet i API, schema eller uppstart.
Källan fungerade först när användarens effektiva stack var tillräckligt väl anpassad för att köra v1.134.0; det fastställer inte att godtycklig blandning av taggar är säker.
Behåll PostgreSQL på lagring som stöds lokalt
Enligt Immichs aktuella krav ska PostgreSQL-datakatalogen använda ett lokalt filsystem och inte ligga på en nätverksresurs. Databastillståndet är vanligtvis litet jämfört med fotobiblioteket, men är avgörande för användare, album, metadata och applikationstillstånd.
Ta reda på om du installerade ZimaOS-paketet eller en anpassad Compose-stack
Om Immich hämtades från ZimaOS App Store använder du butikens aktuella uppdateringsväg och granskar paketändringarna. Om du importerade en egen Compose-konfiguration ansvarar du själv för uppströmsversionens låsning, .env, databassökväg och migreringssteg.
Att blanda redigeringar i appbutiken med en manuellt underhållen uppströmsstack gör framtida felsökning svårare.
Gör en förkontroll inför en större uppgradering
- Bekräfta att fotobiblioteket nyligen har säkerhetskopierats.
- Säkerhetskopiera databasen och applikationstillståndet.
- Notera den aktuella versionen och volymmappningarna.
- Läs uppströms information om brytande förändringar.
- Se till att system-/AppData-enheten har tillräckligt med ledigt utrymme för imagehämtningar och migreringar.
Verifiera den körande versionen och jobben efter uppdateringen
Nöj dig inte med ”Sparandet slutfördes”. Öppna Immichs sida Om/System, bekräfta den körande serverversionen, kontrollera containrarnas hälsa och verifiera sedan uppladdningar, miniatyrer, maskininlärningsjobb och anslutningen till mobilappen.
Källan visar själv varför: att redigera taggen innebar inte omedelbart att den körande instansen faktiskt hade uppdaterats.
Återställning innebär inte alltid bara att ändra tillbaka taggen
När en större version har migrerat databasschemat eller tillståndet kanske det inte går att återgå till en tidigare image. Följ uppströms migrerings- och återställningsanvisningar och använd säkerhetskopior i stället för att anta att en tidigare tagg alltid kan återställa allt.
Vanliga frågor om Immich-uppdateringar
Fungerade metoden med manuella taggar från 2025 för källanvändarens primära system?
Ja, så småningom. Deras test-VM fungerade inte på samma sätt.
Bör nuvarande Immich-användare endast uppdatera taggarna för immich-server och machine-learning?
Nej. Nuvarande Immich v3 underhålls som en komplett Compose-stack med versions- och migreringsanvisningar.
Lovade IceWhale automatiska Immich-uppdateringar i källan?
Nej. Zima-Giorgio sa bara att teamet skulle diskutera begäran.
