Immich veilig updaten op je NAS

Immich ontwikkelt snel. Blind op 'update' drukken is daarom minder slim dan eerst release notes lezen, database en foto's veiligstellen en daarna gecontroleerd vernieuwen.

1. Lees de release notes

Immich noemt breaking changes expliciet. Vooral bij grote versies kan je Compose-configuratie, database of environment variables aandacht nodig hebben.

2. Maak een back-up

Bescherm minimaal je upload/library-map, database en .env. Zorg dat je weet hoe je die gegevens terugzet.

3. Controleer IMMICH_VERSION

Gebruik je een vaste versie in .env, pas die dan bewust aan naar de gewenste release.

4. Haal nieuwe images op

De officiële Compose-route gebruikt docker compose pull gevolgd door docker compose up -d. In Synology Container Manager bereik je hetzelfde via het project: nieuwe images ophalen en het project opnieuw bouwen/starten.

5. Controleer alle containers

Wacht tot server, database, cache en machine learning stabiel draaien. Bekijk de logs als een container blijft restarten.

6. Test de app vóór je oude images opruimt

Log in via web en telefoon, open oudere foto's, upload een testfoto en controleer zoeken/gezichtsherkenning.

7. Oude images opruimen komt als laatste

Pas als alles goed werkt kun je ongebruikte images verwijderen om ruimte terug te winnen.