User Tools

Site Tools


homelab:besluiten:26.009-updatebeleid_containers_wud

This is an old revision of the document!


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

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 latest is 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 op latest geen 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. cpus werkt niet op de DS423+ (kernel zonder CPU CFS-scheduler, Portainer geeft dan een 500-fout); gebruik cpu_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 daar curl -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 met docker rename.
  • Risico’s / aandachtspunten:
    • Een update die ouder is dan zijn afkoeltijd wordt bij de eerstvolgende scan uitgevoerd. Ook bij WATCH NOW.
    • Op latest kan een major-versie toch binnenkomen (Plex, dokuwiki). Mitigatie: afkoeltijd 14d en back-up van de config.
    • Het oude label wud.watch.autoupdate doet niets meer.
    • Onbekend: of een nieuwere release de afkoeltijd opnieuw laat beginnen. De WUD-documentatie zegt er niets over. LinuxServer bouwt latest vaak 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