homelab:besluiten:26.009-updatebeleid_containers_wud
This is an old revision of the document!
Table of Contents
26.009 Updatebeleid containers (WUD)
- Aangemaakt: 2026-10-17
- Context / Aanleiding:
- Ruim 20 containers (Docker via Portainer op de NAS), die ik niet allemaal handmatig wil bijhouden, maar ook niet blind automatisch wil laten updaten.
- De eerste WUD-configuratie werkte niet zoals bedoeld: updates van o.a. Sonarr en Radarr werden nooit gemeld (digest-controle stond uit) en bij het opstarten van WUD begon hij meteen zelf te updaten.
-
- Uitrol afgerond op 2026-10-18: labels, geheugenlimieten, backups en de handmatige updates van Joplin (3.7.2), Plex, Sonarr (4.0.20) en Radarr (6.4.4)
- Eerste echte geplande run: vrijdag 2026-10-23, 09:00
- Meldingen achteraf (geslaagd / mislukt / rollback) werken nog niet, zie Evaluatie
Relaties
| Devices | Services | Tags |
|---|---|---|
| NAS: Synology DS423+ | WUD (What's up Docker) |
Besluit
- Gekozen optie:
- Opt-in. Een container wordt alleen automatisch bijgewerkt als ik dat expliciet heb ingesteld met het label
wud.trigger.docker.autoupdate.enabled=true. - Voor alle andere containers krijg ik alleen een melding (wekelijkse mail, vrijdag 09:00) dat er een update beschikbaar is.
- WUD scant alleen op het ingestelde moment (cron) of als ik zelf op WATCH NOW druk. Niet bij het opstarten en niet bij Docker-events.
- Elke update moet eerst een afkoeltijd (
wud.watch.delay) hebben doorstaan: standaard 3 dagen, per container aan te passen. - Bij een automatische update draait de rollback aan: als de nieuwe container niet gezond start, gaat WUD terug naar de vorige.
- Motivatie:
- Criteria: weinig onderhoud, geen verrassingen, risico per container bepalen op basis van wat er misgaat als het stuk is.
- Alternatief alles automatisch: afgewezen, te riskant voor databases en voor apps met eigen data (Joplin, Plex).
- Alternatief alleen minor standaard automatisch: bij
latestis er geen onderscheid tussen minor en major (WUD ziet daar alleen een nieuwe digest). Kan alleen met versie-tags, en dat past maar bij een paar images. - Alternatief Compose-trigger: niet gekozen, vraagt een mount van de Portainer-map en padmapping, en levert voor deze opzet te weinig op.
Categorieën
| Categorie | Beleid | Applicaties |
|---|---|---|
| A. Laag risico en downloads | Automatisch, ook major | Dozzle, Beszel, Beszel-Agent, docker-iperf3, OmniTools, nicotine, overseerr, Sonarr, Radarr, prowlarr, sabnzbd, qbittorrent, ghostfolio-app |
| B. Stabiel, direct nodig | Automatisch na lange afkoeltijd (14 dagen), zie noot | Plex, Joplin, Homepage, dokuwiki |
| C. Data en infrastructuur | Nooit automatisch, alleen melden | ghostfolio-db, ghostfolio-redis, Joplin-DB, portainerdsm, WUD, Pi-hole |
| D. Buiten WUD | Geen controle, geen melding (wud.watch=false) | beatport-tagger, anythingllm, qdrant, joplin-indexer |
Noot bij B: Joplin en Homepage volgen een versie-tag die alleen binnen de huidige hoofdversie meebeweegt (zie hieronder), dus een major-update komt daar niet vanzelf binnen. Plex en dokuwiki staan op latest: daar is geen onderscheid tussen minor en major te maken. Dat is bewust geaccepteerd; de afkoeltijd van 14 dagen is de bescherming.
Per container
| Categorie | Applicatie (stack) | Image | Labels | Afkoeltijd |
|---|---|---|---|---|
| A | Dozzle, Beszel, Beszel-Agent, docker-iperf3 (20) | latest | AU | 3d |
| A | OmniTools (23) | latest | AU | 3d |
| A | nicotine (53) | latest | AU | 3d |
| A | overseerr, prowlarr, sabnzbd, qbittorrent (37) | latest | AU | 3d |
| A | Sonarr, Radarr (37) | latest | AU | 7d |
| A | ghostfolio-app (42) | latest | AU | 3d |
| B | Joplin (3) | joplin/server:amd64-3 | AU | 14d |
| B | Homepage (4) | ghcr.io/gethomepage/homepage:v2 | AU, wud.watch.digest=true, wud.tag.include=^v2$$ | 14d |
| B | Plex (37) | latest | AU | 14d |
| B | dokuwiki (50) | latest | AU | 14d |
| C | databases, redis, portainerdsm, WUD, Pi-hole | ongewijzigd | geen | alleen melden |
| D | beatport-tagger (60), anythingllm, qdrant, joplin-indexer (58) | ongewijzigd | wud.watch=false | n.v.t. |
AU = wud.trigger.docker.autoupdate.enabled=true. Afkoeltijd instellen met wud.watch.delay=<tijd> (alleen bij afwijking van de standaard van 3 dagen). In een compose-bestand moet $ in een regex dubbel: $$.
Matrix: risico per categorie
Wat WUD per soort update doet. Geldt alleen waar versie-tags of drijvende hoofdversies worden gebruikt; bij latest is er alleen nieuwe digest.
| Soort update | A | B | C | D |
|---|---|---|---|---|
| Geen | niets | niets | niets | niets |
| Security-patch / patch | automatisch | automatisch | melding | niets |
| Minor | automatisch | automatisch | melding | niets |
| Major | automatisch | alleen melding (bij Joplin en Homepage) | melding | niets |
Gevolgen
- Technisch:
- Digest-controle voor Docker Hub staat aan via
WUD_REGISTRY_HUB_PUBLIC_WATCHDIGEST=true(anders zie je oplatestgeen updates). GHCR doet dit standaard al. - Hub-limiet: 200 pulls per 6 uur (ingelogd), ruim voldoende voor een wekelijkse scan.
- Rollback wacht op de healthcheck (max. 5 min), of eist 10 s uptime als de container er geen heeft. Een databasemigratie wordt niet teruggedraaid.
- Geheugenlimieten: de meeste containers hebben een
mem_limit(gebaseerd op gemeten gebruik, ruim erboven), zodat een geheugenlek een herstart van die ene container geeft in plaats van een trage NAS.cpuswerkt niet op de DS423+ (kernel zonder CPU CFS-scheduler, Portainer geeft dan een 500-fout); gebruikcpu_shares(relatief gewicht). - Joplin-DB blijft bewust op
postgres:16: dat is de versie in het officiële voorbeeld van Joplin. De major-sprong naar 18 vraagt dump en restore en levert niets op.
- Operationeel:
- Handmatig bijwerken: knop Update bij de container in de WUD-UI (trigger
docker.manual). - Voor de eerste automatische run: dump van Joplin-DB en ghostfolio-db, en een kopie van de config-mappen van Plex, Sonarr en Radarr.
- Joplin, Plex, Sonarr en Radarr eerst zelf handmatig bijwerken (grote sprong, ~7 maanden achterstand), pas daarna hun label zetten.
- Na een Joplin-update de joplin-indexer één keer draaien: WUD ziet niet of die breekt.
- Stacks in Portainer bijwerken met Re-pull image uit.
- Draaiende versie controleren:
docker inspect <container> --format '{{index .Config.Labels "org.opencontainers.image.version"}}'. Dat is de versie van het image. Bij Plex klopt dat niet, omdat die container zichzelf bijwerkt; gebruik daarcurl -s http://localhost:32400/identity. - Staat een container op Cooling down, dan biedt WUD mogelijk geen Update-knop. Bijwerken kan dan via Portainer: Containers → Recreate met Pull latest image version.
- Een mislukte stack-deploy in Portainer kan een container achterlaten met een hash-voorvoegsel (bijv.
38d3eb85889b_qdrant). Herstellen metdocker rename.
- Risico’s / aandachtspunten:
- Een update die ouder is dan zijn afkoeltijd wordt bij de eerstvolgende scan uitgevoerd. Ook bij WATCH NOW.
- Op
latestkan een major-versie toch binnenkomen (Plex, dokuwiki). Mitigatie: afkoeltijd 14d en back-up van de config. - Het oude label
wud.watch.autoupdatedoet niets meer. - Onbekend: of een nieuwere release de afkoeltijd opnieuw laat beginnen. De WUD-documentatie zegt er niets over. LinuxServer bouwt
latestvaak wekelijks opnieuw (nieuwe digest zonder nieuwe app-versie); als de timer dan telkens reset, haalt Sonarr/Radarr met 7d nooit de afkoeltijd. Beoordelen bij de eerste echte run; zo nodig terug naar 3d.
Evaluatie
- Ervaring:
- Nog niet beoordeeld; eerste echte run is 2026-10-23.
- Tijdelijke backups van de uitrol (dumps van Joplin-DB en ghostfolio-db, en een kopie van de config van Plex, Sonarr en Radarr) opruimen na ongeveer een week zonder problemen.
- Open vervolg: qdrant-server (1.17.0) loopt achter op de qdrant-client die de joplin-indexer bij elke start installeert (waarschuwing, geen fout). Server bijwerken of de client vastzetten.
- Bekend probleem: de mails Update SUCCESS / FAILED / Rollback komen niet aan, ook niet met WUD 9.4.1. In het debuglog staat wel “Handling successful update event”, maar er wordt geen mail verstuurd en er is geen fout. De testmail uit de WUD-UI werkt wel. Mogelijke vervolgstappen: melden bij het WUD-project op GitHub (met log), trace-niveau, of een post-update-hook.
- Wanneer herbeoordelen:
- Na de eerste geplande run en na de eerste automatische update van een categorie-B-container.
- Als een app in A of B toch kapotgaat na een update: container verplaatsen naar een voorzichtiger categorie.
- Aanleiding voor herziening:
- Nieuwe containers (indelen in A/B/C/D bij installatie).
- Wijzigingen in WUD (nieuwe versie, wijziging in labels of triggers).
homelab/besluiten/26.009-updatebeleid_containers_wud.1792503799.txt.gz · Last modified: by miels
