De workaround uit de bron was praktisch voor één Immich-pakket uit 2025, maar mag niet zonder meer worden vastgezet in een actuele upgradehandleiding. Een communitygebruiker wijzigde handmatig de immich-server en immich-machine-learning imagetags naar v1.134.0. De oorspronkelijke poster zei dat dit uiteindelijk werkte op het primaire ZimaOS-systeem, maar niet op een test-VM.
Immich is sindsdien overgegaan naar v3 en het onderhouden implementatiemodel gebruikt een volledige Docker Compose-stack plus een waarde IMMICH_VERSION. Als je slechts één of twee servicetags bijwerkt, kan er een stack met gemengde versies ontstaan wanneer de aannames voor de database, cache, machine learning of API zijn gewijzigd.
De bron uit 2025 bewerkte afzonderlijke Immich-servicetags
De community vertelde de gebruiker dat zowel de server als Machine Learning moest worden gewijzigd
CogZog zei: beide immich-server en immich-machine-learning moet de nieuwe tag gebruiken. De gebruiker bevestigde dat beide waren gewijzigd, maar de test-VM bleef nog op de oudere versie.
De primaire ZimaOS-build bereikte uiteindelijk v1.134.0
De bron stelde geen regel vast om de database-image handmatig bij te werken
beep vroeg of de database ook naar een nieuwere/stabiele tag moest worden verplaatst. De reactie van de community kwam in wezen neer op: “als het niet kapot is, repareer het dan niet.” Dat was een mening, geen migratiebeleid van Immich.
De huidige Immich-versie is v3, met een volledig Compose-updatepad
Immich v3.0.0 werd in juli 2026 uitgebracht. Upstream geeft aan dat je de onderhouden stack bijwerkt door IMMICH_VERSION=v3 en voer het normale Compose-pull-/recreatieproces uit, en bekijk daarbij ook de notities over breaking changes en migratie voor v3.
Zie de huidige richtlijnen voor de Immich v3-release.
De huidige upstreamversie raadt de volledige Docker Compose-bundel aan
In de huidige installatiedocumentatie van Immich wordt gebruikers verteld dat ze de release moeten downloaden docker-compose.yml en .env, stel vervolgens de locaties in en IMMICH_VERSION. Het PostgreSQL-databasepad moet op een ondersteund lokaal bestandssysteem blijven staan en niet op een netwerkshare.
Gebruik het huidige Immich Compose-model voor handmatige/aangepaste implementaties.
Geef voor het ZimaOS App Store-pakket de voorkeur aan de huidige app-updateprocedure
De huidige ZimaOS App Store 2.0 bevat beheer voor updates van geïnstalleerde apps. Als het storepakket een Immich-update aanbiedt, laat dan de pakketdefinitie de volledige stack met meerdere services bijwerken in plaats van één servicetag afzonderlijk te bewerken.
Maak een back-up voordat je Immich ingrijpend bijwerkt
Maak vóór een wijziging van de hoofdversie een back-up van zowel de foto- en videobibliotheek als de database- en applicatiestatus. Alleen een gezonde bibliotheekmap is niet voldoende om albums, gebruikers, metagegevens en de applicatiestatus te reconstrueren.
Een Immich-stack met gemengde versies vermijden
Immich is niet één onafhankelijke container. De applicatie, machinelearningservice, database en andere ondersteunende componenten worden getest als een gecoördineerde releasetopologie. Als één image wordt bijgewerkt terwijl een ander vastgepind blijft, kunnen API-, schema- of opstartincompatibiliteiten ontstaan.
De bron werkte pas nadat de effectieve stack voldoende op elkaar was afgestemd om v1.134.0 uit te voeren; dit bewijst niet dat het willekeurig combineren van tags veilig is.
PostgreSQL op ondersteunde lokale opslag houden
Volgens de huidige Immich-vereisten moet de PostgreSQL-databasemap een lokaal bestandssysteem gebruiken en mag deze niet op een netwerkshare staan. De databasestatus is doorgaans klein vergeleken met de fotobibliotheek, maar is essentieel voor gebruikers, albums, metadata en de applicatiestatus.
Controleer of je het ZimaOS-pakket of een aangepaste Compose-stack hebt geïnstalleerd
Als Immich uit de ZimaOS App Store kwam, gebruik dan de huidige updatemethode van de store en bekijk de wijzigingen in het pakket. Als je je eigen Compose hebt geïmporteerd, ben je zelf verantwoordelijk voor de upstream-versiepin, .env, het databasepad en de migratiestappen.
Het combineren van bewerkingen in de App Store met een handmatig onderhouden upstream-stack maakt toekomstige probleemoplossing moeilijker.
Voer een controle voorafgaand aan een grote upgrade uit
- Bevestig dat er een recente back-up van de fotobibliotheek is.
- Maak een back-up van de database en applicatiestatus.
- Noteer de huidige versie en volumekoppelingen.
- Lees de upstream-notities over wijzigingen die compatibiliteit verbreken.
- Zorg ervoor dat de systeem-/AppData-schijf voldoende vrije ruimte heeft voor het ophalen van images en migraties.
Controleer na het bijwerken de actieve versie en taken
Stop niet bij ‘Opslaan voltooid’. Open de pagina About/System van Immich, controleer de versie van de actieve server, controleer de containerstatus en verifieer vervolgens uploads, miniaturen, machine-learningtaken en de verbinding met de mobiele app.
De bron laat zelf zien waarom: de tag bewerken betekende niet meteen dat de actieve instantie daadwerkelijk was bijgewerkt.
Terugdraaien is niet altijd zo eenvoudig als de tag terugzetten
Zodra een grote release het databaseschema of de status heeft gemigreerd, wordt teruggaan naar een eerdere image mogelijk niet ondersteund. Volg de migratie- en terugdraa richtlijnen van de upstream-versie en maak back-ups, in plaats van ervan uit te gaan dat een eerdere tag altijd als universele terugdraaiknop werkt.
Veelgestelde vragen over Immich-updates
Werkte de handmatige tagmethode uit 2025 voor het primaire systeem van de gebruiker in de bron?
Ja, uiteindelijk wel. Hun test-VM gedroeg zich niet hetzelfde.
Moeten huidige Immich-gebruikers alleen de tags van immich-server en machine-learning bijwerken?
Nee. De huidige Immich v3 wordt onderhouden als een volledige Compose-stack, met richtlijnen voor versies en migraties.
Heeft IceWhale in de bron automatische Immich-updates beloofd?
Nee. Zima-Giorgio zei alleen dat het team het verzoek zou bespreken.
