Immich handmatig bijwerken op ZimaOS

Als de in ZimaOS weergegeven Immich-versie ouder is dan de upstream Immich-release en de App Store geen knop voor bijwerken biedt, kun je de containers handmatig bijwerken—maar de juiste methode hangt af van het ZimaOS-Immich-pakket dat je hebt geïnstalleerd. De IceWhale Community-discussie van december 2025 bevestigde een eenvoudige wijziging van de imagetag voor het BigBear Immich-pakket, terwijl latere antwoorden lieten zien dat dezelfde truc niet bij elk ander Immich-pakket betrouwbaar werkte.

De communitymethode was om de app-instellingen te openen en alleen de immich-server en immich-machine-learning imagetags naar de doelrelease, waarbij de database- en Redis-tabbladen ongemoeid werden gelaten. De oorspronkelijke plaatser bevestigde dat de update soepel verliep, en een andere BigBear-gebruiker werkte later met succes bij van v2.3.1 naar v2.4.1. De huidige Immich-documentatie vereist echter dat beheerders de releaseopmerkingen lezen, een back-up van de database maken en rekening houden met wijzigingen in Compose en de database voordat ze upgraden. Handmatig tags wijzigen mag daarom niet worden beschouwd als een universele knop voor een “altijd veilige” update.

Identificeer eerst welk Immich-pakket je hebt geïnstalleerd

De discussie bevat ten minste twee implementatiepaden:

• BigBear Immich: verschillende gebruikers meldden dat het bewerken van de imagetags in ZimaOS met succes een update activeerde.
• Oorspronkelijk/niet-BigBear-pakket: een latere gebruiker meldde dat hij vastzat op v2.1.0, zelfs nadat hij had geprobeerd de server- en machine-learningversies handmatig te wijzigen.

Open de instellingen van de Immich-app in ZimaOS en noteer de huidige imagenamen, tags, volumetoewijzingen, database-image en omgevingsvariabelen voordat je iets wijzigt. Ga er niet van uit dat instructies voor de BigBear-definitie overeenkomen met een andere App Store-sjabloon.

De BigBear-tagupdate die in de community werkte

De succesvolle procedure uit de community was:

1. Open op het ZimaOS-dashboard het menu met de drie puntjes bij de Immich-app.
2. Selecteer Instellingen.
3. Open het tabblad immich-machine-learning.
4. Wijzig de Tag van de image naar de gewenste Immich-release.
5. Open het tabblad immich-server.
6. Stel daar dezelfde releasetag in.
7. Laat de tabbladen voor de database en Redis ongewijzigd, tenzij de releaseopmerkingen expliciet een wijziging van de database of container vereisen.
8. Sla de configuratie op en laat ZimaOS de betreffende containers opnieuw aanmaken/ophalen.

Ten tijde van het oorspronkelijke antwoord was de voorbeeldtag:

v2.3.1

Die versie is historisch. Een andere gebruiker werkte later bij naar v2.4.1, en in een antwoord uit april 2026 werd vermeld v2.7.4. Kopieer vandaag geen van die oude versienummers. Kies pas een doelversie nadat je de actuele releaseopmerkingen van Immich en je upgradepad hebt gecontroleerd.

Wat de oorspronkelijke plaatser bevestigde

Na ontvangst van de instructies voor de BigBear-tag antwoordde MikeFrizz dat de tip erg nuttig was en dat de update soepel was voltooid. Dit is het sterkst bevestigde resultaat in de brondiscussie.

Die bevestiging ondersteunt de methode voor het pakket en de versiecontext die de oorspronkelijke poster gebruikte. Dit bewijst niet dat het handmatig bewerken van twee tags voldoende is voor elke toekomstige hoofdversie van Immich of elk ZimaOS-pakket.

Ga er niet van uit dat de tag 'latest' het probleem oplost

Eén gebruiker wijzigde de tag naar latest, maar ZimaOS keerde steeds terug naar de eerder geïnstalleerde versie. In de thread staan vervolgens gissingen, zoals het proberen van release, maar er is geen universele, door de bron bevestigde oplossing op basis van zulke algemene tagnamen.

In de huidige Immich-documentatie wordt een expliciete versievariabele gebruikt en worden metatags voor hoofdversies ondersteund in de eigen Docker Compose-workflow. Gebruik voor een verpakte ZimaOS-app de tagindeling die de pakketdefinitie en de upstream-image daadwerkelijk ondersteunen. Bedenk geen tags omdat een label aannemelijk klinkt.

Maak een back-up van Immich voordat je van versie wisselt

De huidige Immich-documentatie raadt uitdrukkelijk aan om vóór upgrades waarbij migraties kunnen plaatsvinden een back-up van de database te maken. Ook je foto's en video's hebben een onafhankelijke back-upstrategie nodig; een databaseback-up vervangt de mediabibliotheek zelf niet.

Gebruik de huidige handleiding voor back-up en herstel van Immich vóór een handmatige versiesprong.

Bewaar minimaal:

• de back-up van de Immich-database;
• de mediabibliotheek/uploadgegevens;
• de huidige ZimaOS-appconfiguratie en volumekoppelingen;
• de huidige imagetags;
• en eventuele omgevingsvariabelen of aangepaste opslaglocaties.

Lees vóór elke versiesprong de releaseopmerkingen van Immich

In de huidige upgradocumentatie van Immich staat dat beheerders vóór het bijwerken de releaseopmerkingen moeten controleren op wijzigingen die incompatibiliteit kunnen veroorzaken. Het normale upstream-proces voor Docker Compose is:

docker compose pull && docker compose up -d

maar pas nadat de Compose-definitie en versievariabelen geschikt zijn voor de doelrelease.

Bekijk de huidige upgradehandleiding voor Immich.

Dit is belangrijk voor ZimaOS, omdat een verpakte app niet alleen achter kan lopen met imagetags, maar ook met de Compose-equivalente definitie. Een nieuwere immich-server Voor de image kunnen wijzigingen in de database, omgeving, healthcheck of volumes vereist zijn die een ouder pakket niet bevat.

Houd de versies van Immich Server en Machine Learning compatibel

De community heeft specifiek de tags voor beide gewijzigd immich-server en immich-machine-learningOok de huidige Immich-documentatie waarschuwt dat versieverschillen tussen de hoofdserver en de machine-learningcomponenten bugs of instabiliteit kunnen veroorzaken.

Werk niet slechts één van de twee bij omdat die toevallig als eerste een beschikbare image aangaf. Behandel ze als één gecoördineerde applicatieversie, tenzij de documentatie voor de huidige release uitdrukkelijk anders vermeldt.

Wijzig de tag van de databasecontainer niet willekeurig.

Het communityadvies om het databasetabblad ongemoeid te laten was verstandig voor de specifieke BigBear-minorupdates die daar werden besproken. De PostgreSQL-laag van Immich heeft eigen migraties en is in de loop der tijd veranderd, waaronder de migratie van oudere vectorextensies naar VectorChord.

• Verhoog de database-image niet alleen om alle tags numeriek op elkaar te laten lijken.
• Ga er niet van uit dat de database-image nooit mag veranderen; als de huidige Immich-releaseopmerkingen een database-/Compose-migratie vereisen, volg dan die gedocumenteerde migratie.

Wat als de oorspronkelijke Immich-app op ZimaOS op een oude versie blijft?

Een reactie uit maart 2026 zei dat de gebruiker niet de BigBear App Store-versie draaide en nog steeds vastzat op Immich v2.1.0, zelfs nadat die handmatig had geprobeerd de machine-learning- en server-images bij te werken. De thread bevat geen bevestigde oplossing voor de oorspronkelijke pakketimplementatie van die gebruiker.

Dat is een belangrijke grens: als het handmatig wijzigen van de image-tags de app niet bijwerkt, blijf dan niet dezelfde handeling herhalen. Vergelijk de huidige containerdefinitie van het pakket met de huidige Compose-vereisten van Immich en overweeg pas na het maken van een back-up en het bevestigen van de gegevenspaden een migratie naar een onderhouden ZimaOS-pakket.

Verwijder een werkend Immich-pakket niet voordat je weet waar de database- en mediavolumes zijn opgeslagen.

Waarom communitygebruikers het BigBear Immich-pakket aanraadden

Het eerste antwoord raadde de BigBear Immich-app aan, omdat die doorgaans beter werd bijgehouden in lijn met upstream-releases. De latere, succesvolle instructies voor het bewerken van tags waren ook expliciet getest op BigBear.

Dit maakt “BigBear opnieuw installeren” nog geen veilige migratie met één klik voor een bestaande bibliotheek. Een nieuw pakket kan andere volumenamen, gegevensmappen, database-images of omgevingsvariabelen gebruiken. Behandel pakketmigratie als een aparte handeling, los van het bijwerken van een bestaande stack.

Wees voorzichtig met automatische container-updaters

Een communityreactie uit april 2026 noemde Tugtainer als eenvoudiger alternatief voor Watchtower om containers te controleren en automatisch bij te werken. Dat kan handig zijn voor stateless services, maar Immich is een stateful applicatie met meerdere containers, een PostgreSQL-database en gedocumenteerde upgradepaden voor breaking changes.

Bij Immich kan het automatisch vervangen van images zonder de releaseopmerkingen te lezen riskant zijn. De huidige Immich-documentatie zegt beheerders expliciet dat ze vóór upgrades rekening moeten houden met breaking changes. Als je überhaupt een automatische container-updater gebruikt, geef dan voor Immich de voorkeur aan meldingen of handmatige goedkeuring in plaats van blind elke nieuwe tag bij te werken.

Veiliger workflow voor het bijwerken van Immich op ZimaOS

1. Noteer of het geïnstalleerde pakket BigBear is of een andere Immich-definitie.
2. Noteer de huidige server-, machinelearning-, database- en Redis-images/tags.
3. Maak een back-up van de Immich-database en belangrijke media.
4. Lees de upstream-releaseopmerkingen voor elke grens met mogelijk breaking changes tussen je huidige en doelversie.
5. Controleer of de doelversie wijzigingen in Compose, de database, omgevingsvariabelen of opslag vereist.
6. Wijzig voor een compatibele BigBear-minorupdate de server- en machine-learning-tags samen, zoals de community deed.
7. Laat database-/Redis-images ongewijzigd, tenzij het gedocumenteerde upgradepad specifiek een wijziging vereist.
8. Sla de app-instellingen op en bekijk de containerlogboeken terwijl de nieuwe images starten.
9. Controleer de versie van de Immich-webinterface, uploads, miniaturen, machine learning en je bestaande bibliotheek voordat je oude images verwijdert.
10. Als het pakket onmiddellijk terugdraait of op de oude versie blijft staan, controleer dan de pakketdefinitie in plaats van tags herhaaldelijk te forceren.

Wat je na een Immich-update moet controleren

• De webinterface wordt geladen en toont de bedoelde serverversie.
• De mobiele app kan verbinding maken en is compatibel met de hoofdversie van de server.
• Bestaande foto's en video's worden correct geopend.
• Nieuwe uploads worden succesvol voltooid.
• Taken voor miniaturen en transcodering worden uitgevoerd.
• Machine-learningfuncties starten zonder fouten door versieverschillen.
• De PostgreSQL-container blijft gezond.

De huidige Immich-documentatie vermeldt dat downgraden geen ondersteunde herstelstrategie is. Een back-up is veiliger dan ervan uitgaan dat je na een databasemigratie eenvoudig de tag kunt terugzetten.

Veelgestelde vragen over Immich-updates op ZimaOS

Kan ik Immich bijwerken door de ZimaOS-image-tags te wijzigen?

Ja, voor sommige pakket-/versiecombinaties. De oorspronkelijke poster en een andere BigBear-gebruiker bevestigden dat het wijzigen van zowel de server- als machine-learning-tags werkte. De thread bevat ook een gebruiker buiten BigBear bij wie de methode de verouderde installatie niet oploste.

Welke Immich-tags moet ik wijzigen?

In de bevestigde BigBear-communitymethode werden de immich-server en immich-machine-learning tags samen werden gewijzigd. Kopieer de oude voorbeelden v2.3.1, v2.4.1 of v2.7.4 niet als huidige doelversies.

Moet ik latest gebruiken?

Niet als universele oplossing. Een gebruiker in de thread meldde dat latest bleek niet te werken. Gebruik het versiebeheerschema dat door je daadwerkelijke pakket en de huidige Immich-richtlijnen wordt ondersteund.

Kan ik gewoon docker pull uitvoeren?

Alleen een nieuwe image ophalen maakt de actieve container niet opnieuw aan en past Compose-wijzigingen niet toe. Immich gebruikt upstream docker compose pull && docker compose up -d nadat de configuratie voor de doelrelease is voorbereid.

Moeten Tugtainer of Watchtower Immich automatisch bijwerken?

Automatische updates kunnen de controle van releaseopmerkingen en migraties overslaan die Immich uitdrukkelijk aanbeveelt. Voor een stateful applicatie met een database zijn meldingen en gecontroleerde handmatige upgrades veiliger dan een blinde automatische vervanging.

Heb ik een back-up nodig vóór een Immich-update?

Ja. De huidige upgrade- en back-updocumentatie van Immich raadt aan de database vóór upgrades te beschermen; onvervangbare media moet je afzonderlijk veiligstellen.