User Tools

Site Tools


homelab:services:wud

WUD (What's up Docker)

Afwijkende instellingen (met reden)

  • Login verplicht met één admin-account (wud-admin). Reden: WUD kan containers bijwerken en is via internet bereikbaar.
  • Watcher LOCAL (via de Docker-socket):
    • WATCHBYDEFAULT=true, WATCHALL=false. Reden: alle draaiende containers volgen, gestopte niet.
    • Cron: vrijdag 07:00 UTC. WATCHATSTART=false en WATCHEVENTS=false. Reden: alleen scannen op een vast moment of bij WATCH NOW, zodat er niets onverwachts gebeurt.
    • DELAY=3d. Reden: standaard afkoeltijd uit het beleid.
  • Triggers:
    • docker.autoupdate met INCLUDEBYDEFAULT=false, prune en rollback. Reden: opt-in; alleen containers met het label voor autoupdate.
    • docker.manual: de knop Update in de UI, voor alle containers. Voert niets zelf uit.
    • smtp.gmail in batch. Reden: één wekelijkse mail met alle beschikbare updates in plaats van één per container.
  • Registries:
    • Docker Hub met login en WUD_REGISTRY_HUB_PUBLIC_WATCHDIGEST=true. Reden: zonder digest-controle zie je op latest geen updates; met login is het pull-limiet hoger (200 per 6 uur).
    • GHCR met token. Reden: Homepage en nicotine staan op ghcr.io. GHCR controleert de digest standaard al.
  • Loglevel info. debug alleen tijdelijk bij het zoeken naar een probleem.

Labels

Te zetten in de compose van de container.

Label Betekenis
wud.trigger.docker.autoupdate.enabled=true Deze container mag automatisch bijgewerkt worden (opt-in)
wud.watch.delay=7d Afwijkende afkoeltijd (alleen bij afwijking van 3 dagen)
wud.watch=false Container volledig buiten WUD houden (categorie D)
wud.watch.digest=true Ook op digest controleren (nodig bij een drijvende tag als v2)
wud.tag.include=^v2$$ Alleen tags die deze regex matchen. In compose moet $ dubbel: $$

Het oude label wud.watch.autoupdate doet niets meer.

Indeling per container

Categorieën en hun criteria: zie het updatebeleid. AU = wud.trigger.docker.autoupdate.enabled=true. Het getal tussen haakjes is het stacknummer in Portainer.

Categorie Container (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 ghostfolio-db, ghostfolio-redis, Joplin-DB, portainerdsm, WUD, Pi-hole ongewijzigd geen alleen melden
D beatport-tagger (60), anythingllm, qdrant, joplin-indexer (58) ongewijzigd wud.watch=false n.v.t.

Beheer

  • Opzet: versie 9.4.1, eigen stack in Portainer (stack 48), store (instellingen en geschiedenis) in /volume2/docker/wud2.
  • Handmatig bijwerken: WUD-UI, tabblad Containers, bij de container Update. Bij containers met eigen data eerst een back-up.
  • Container staat op Cooling down: WUD biedt dan mogelijk geen Update-knop. Bijwerken via Portainer: Containers → Recreate met Pull latest image version.
  • Stacks in Portainer bijwerken met Re-pull image uit, zodat er geen image-update buiten WUD om binnenkomt.
  • Mislukte stack-deploy: Portainer kan een container achterlaten met een hash-voorvoegsel (bijv. 38d3eb85889b_qdrant). Herstellen met docker rename.
  • Draaiende versie controleren: docker inspect <container> --format '{{index .Config.Labels "org.opencontainers.image.version"}}'. Dit is de versie van het image; bij Plex klopt dat niet, zie Plex.
  • Logs: via Dozzle. Bij problemen met meldingen eerst de test-trigger in de UI proberen.
  • Bekend probleem: de mails Update SUCCESS / FAILED / Rollback komen niet aan (ook niet met 9.4.1). In het debuglog staat “Handling successful update event”, maar er gaat geen mail uit en er is geen fout. De testmail uit de UI werkt wel.

Backups

Volgens de backupstandaard: de store staat op de docker-share (volume 2) en valt onder de NVMe-backup. De compose staat in Portainer. Geen afwijkingen.

Relaties

homelab/services/wud.txt · Last modified: by miels