Als Immich op ZimaOS op een oude versie blijft nadat je alleen de imagetag van immich-server hebt bewerkt, stop dan met het één voor één wijzigen van containers en bepaal eerst welk pakket en welke stack je gebruikt. Immich is een toepassing met meerdere services; de server-, machinelearning-, database- en cachecomponenten moeten compatibel blijven, en sommige ZimaOS-pakketten worden door verschillende appstorebronnen beheerd.
De brondiscussie laat zien waarom een update van één veld kan mislukken: de gebruiker wijzigde de server-image, zag netwerkactiviteit voor het downloaden, startte opnieuw op, en Immich meldde nog steeds v2.6.1. Een andere gebruiker liet een werkende v3.1.0-configuratie zien met overeenkomende service-images. De juiste aanpak is daarom: “maak een back-up, bepaal welke stack je gebruikt, werk alles coherent bij en controleer het resultaat”, niet: “voer een hoger nummer in één veld in.”
Stap 1: Bepaal welk Immich-pakket je hebt geïnstalleerd
ZimaOS kan pakketten uit de officiële winkel en uit winkels van derden of de community bevatten. Open de appinstellingen en noteer elke service-image, niet alleen immich-server.
Noteer ook de bron van de appstore, zodat je weet wie de updatemetadata beheert.
Stap 2: Maak een back-up van Immich voordat je een grote update uitvoert
Maak een back-up van de fotobibliotheek en de PostgreSQL-database. De huidige handleiding voor back-up en herstel van Immich beschrijft een workflow voor het maken van een databas dump.
Beschouw het opnieuw aanmaken van een container niet als een back-up.
Stap 3: Controleer alle serviceversies
In de bronvergelijking stond:
- Immich-server;
- Immich-machinelearning;
- Postgres;
- Valkey/Redis.
Noteer de volledige imagetags. Als de appstore ze als een geteste bundel beheert, geef dan de voorkeur aan de updateactie boven het handmatig vooruitzetten van één onderdeel ten opzichte van de andere.
Stap 4: Gebruik de updatefunctie van de App Store wanneer deze beschikbaar is
In de huidige ZimaOS-documentatie staat dat het nieuwste Immich-pakket vanuit de App Store kan worden geïnstalleerd. Als er een updateknop beschikbaar is, gebruik die dan zodat de Compose-definitie van de pakketbeheerder tegelijk wordt bijgewerkt.
De huidige ZimaOS Immich-handleiding is het huidige officiële startpunt voor ZimaOS.
Waarom het bewerken van één tag wel lijkt te downloaden maar niet bij te werken
De appbeheerder kan een nieuwe image ophalen, maar de service opnieuw aanmaken op basis van winkelmetadata, een andere opgeslagen YAML-waarde of een andere imagedefinitie. De actieve container kan daardoor terugkeren naar de oude tag.
Controleer de daadwerkelijk actieve image met:
docker ps --format '{.Names} {.Image}'Spring niet blind over meerdere hoofdversies van Immich heen
Immich-releases kunnen wijzigingen aan de database, het schema en services bevatten. Lees de upstream release-/upgradenotities voor de versies waartussen je migreert. Werk de stack als geheel bij in plaats van compatibele combinaties te raden.
Als je een BigBear- of ander pakket van derden gebruikt
Een afzonderlijke ZimaSpace-communityhandleiding beschrijft dat het wijzigen van imagetags voor sommige BigBear-pakketten werkte, terwijl latere gebruikers ontdekten dat dezelfde truc niet voor alle pakketten werkte. Bepaal de bron van het pakket voordat je die workaround toepast.
De Immich-updatehandleiding legt die pakketspecifieke grens uit.
Controleer de update nadat je de stack opnieuw hebt aangemaakt
Controleer drie plaatsen:
- de tags van de actieve Docker-images;
- de eigen serverversieweergave van Immich;
- containerlogboeken voor migratie- of compatibiliteitsfouten.
Verwijder de database of uploadmap niet om een update te forceren
Het verwijderen van volumes is een destructieve reset, geen updatemethode. Behoud de database en fotobibliotheek, tenzij je een geteste back-up hebt en bewust een nieuwe installatie wilt.
Veelgestelde vragen
Waarom toont Immich nog steeds 2.6.1 nadat ik de servertag heb gewijzigd?
De app maakt mogelijk opnieuw de oude servicedefinitie aan, of de stack is niet consistent bijgewerkt. Controleer de daadwerkelijk actieve image en de bron van het pakket.
Moet machine learning exact overeenkomen met de serverversie?
Volg de geteste versies in de Immich-release-/Compose-definitie die je implementeert. Bedenk geen onafhankelijke tags voor elke service.
Kan ik alleen immich-server bijwerken?
Vermijd dat als standaardaanpak. Immich is een stack met meerdere services en upgrades kunnen gecoördineerde wijzigingen vereisen.
Wat moet ik als eerste back-uppen?
De PostgreSQL-database en je media-/uploadopslag. Controleer de back-up vóór wijzigingen aan de hoofdversie.
