Docker Compose-project op Synology veilig updaten

Een container is vervangbaar. Je data is dat niet. Een veilige update draait daarom om persistente volumes, Compose-bestand en environment variables.

1. Weet waar je data staat

Controleer bind mounts en volumes voordat je iets verwijdert. Database- en configuratiemappen moeten buiten de tijdelijke container staan.

2. Bewaar Compose en .env

Maak een kopie van docker-compose.yml en eventuele .env-bestanden. Daarmee kun je de oude configuratie reconstrueren.

3. Lees release notes van de app

Een nieuwe image kan migraties of nieuwe variabelen vereisen. Update nooit puur omdat een nieuw tagnummer beschikbaar is.

4. Haal nieuwe images op

In Compose-termen: pull de nieuwe images en start het project opnieuw. Container Manager kan dit vanuit de projectomgeving uitvoeren.

5. Controleer logs direct na start

Let op database-migraties, permission errors, poortconflicten en ontbrekende variabelen.

6. Gooi oude images pas later weg

Oude images kosten opslag maar kunnen nuttig zijn bij snelle rollback. Ruim pas op nadat de nieuwe versie stabiel draait.

7. Nooit een volume verwijderen zonder te weten wat erin zit

Een container opnieuw maken is normaal. Een persistent volume wissen kan je database of configuratie definitief verwijderen.