User Tools

Site Tools


homelab:services:wud

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
homelab:services:wud [2026/10/17 16:27] – external edit 127.0.0.1homelab:services:wud [2026/10/20 17:20] (current) – [WUD (What's up Docker)] status: vastgesteld miels
Line 1: Line 1:
 ====== WUD (What's up Docker) ====== ====== WUD (What's up Docker) ======
  
-  * **Wat**: Houdt bij of er nieuwe versies van Docker-images zijn, meldt dat per mail en werkt alleen de containers bij waarvoor ik dat expliciet heb ingesteld +  * **Wat**: Houdt bij of er nieuwe versies van Docker-images zijn, meldt dat per mail en werkt alleen de containers bij waarvoor dat expliciet is ingesteld. 
-  * **Doel**: Containers up-to-date houden met minimaal handwerk, zonder onverwachte updates +  * **Doel**: Containers up-to-date houden met minimaal handwerk, zonder onverwachte updates. Het beleid staat in [[homelab:besluiten:26.009-updatebeleid_containers_wud|het updatebeleid voor containers]]. 
-  * **Link**: Web-UI van WUD (login met het ''wud-admin''-account) +  * **GUI**: [[https://wud.miels.synology.me/|de webinterface van WUD]] 
-  * **Device**: [[..:devices:synology_ds423|Synology DS423+]] +  * **Device**: [[homelab:devices:synology_ds423|Synology DS423+]] 
-  * **[[resources:metadata:tags:status|Status]]**: {{tag>"wip"}} +  * **[[resources:metadata:tags:status|Status]]**: {{tag>vastgesteld}}
-    * Uitrol van de labels per stack loopt nog +
-    * Meldingen na een update (succes / mislukt / rollback) werken nog niet +
-    * Beleid en categorieën: zie [[homelab:besluiten:26.009_updatebeleid_containers_wud]]+
  
-===== Opzet ===== +===== Afwijkende instellingen (met reden) ===== 
-  * Versie 9.4.1, draait als eigen stack in Portainer (stack 48), eigen store in ''/volume2/docker/wud2'' +  * Login verplicht met één admin-account (''wud-admin''). Reden: WUD kan containers bijwerken en is via internet bereikbaar. 
-  * Login verplicht: één admin-account (''wud-admin''); wachtwoord staat alleen in de stack, niet hier +  * **Watcher** ''LOCAL'' (via de Docker-socket): 
-  * **Watcher** (naam ''LOCAL''): kijkt via de Docker-socket naar alle containers (''WATCHBYDEFAULT=true''), maar niet naar gestopte (''WATCHALL=false'') +    * ''WATCHBYDEFAULT=true'', ''WATCHALL=false''. Reden: alle draaiende containers volgen, gestopte niet. 
-    * Scant alleen volgens cron: vrijdag 07:00 UTC (= 09:00 lokale tijd), of als ik //WATCH NOW// druk +    * 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. 
-    * ''WATCHATSTART=false'' en ''WATCHEVENTS=false'': niet bij het opstarten en niet bij Docker-events +    * ''DELAY=3d''. Reden: standaard afkoeltijd uit het beleid. 
-    * Standaard afkoeltijd 3 dagen (''DELAY=3d'') +  * **Triggers**: 
-  * **Triggers** +    * ''docker.autoupdate'' met ''INCLUDEBYDEFAULT=false'', prune en rollback. Reden: opt-in; alleen containers met het label voor autoupdate. 
-    * ''docker.autoupdate'': automatisch bijwerken, alleen voor containers met het label ''wud.trigger.docker.autoupdate.enabled=true'' (''INCLUDEBYDEFAULT=false''). Met prune en rollback. +    * ''docker.manual'': de knop //Update// in de UI, voor alle containers. Voert niets zelf uit. 
-    * ''docker.manual'': de knop //Update// in de UI, geldt 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. 
-    * ''smtp.gmail'': wekelijkse mail met alle beschikbare updates (batch, één mail) +  * **Registries**: 
-  * **Registries**: Docker Hub met login en digest-controle aan; GHCR met token (Homepage en nicotine staan op ghcr.io)+    * 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 ===== ===== Labels =====
 +Te zetten in de compose van de container.
 +
 ^ Label ^ Betekenis ^ ^ Label ^ Betekenis ^
 | ''wud.trigger.docker.autoupdate.enabled=true'' | Deze container mag automatisch bijgewerkt worden (opt-in) | | ''wud.trigger.docker.autoupdate.enabled=true'' | Deze container mag automatisch bijgewerkt worden (opt-in) |
-| ''wud.watch.delay=7d'' | Afwijkende afkoeltijd voor deze container | +| ''wud.watch.delay=7d'' | Afwijkende afkoeltijd (alleen bij afwijking van 3 dagen) | 
-| ''wud.watch=false'' | Container volledig buiten WUD houden |+| ''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.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) |+| ''wud.tag.include=^v2$$'' | Alleen tags die deze regex matchen. In compose moet ''$'' dubbel: ''$$'' |
  
-===== Handmatig bijwerken ===== +Het oude label ''wud.watch.autoupdate'' doet niets meer.
-  - WUD-UI, tabblad //Containers// +
-  - Bij de container: //Update// (trigger ''docker.manual'') +
-  - Bij gevoelige containers eerst een back-up (zie [[homelab:besluiten:26.009_updatebeleid_containers_wud|besluit]])+
  
-===== Backups ===== +===== Indeling per container ===== 
-  * **Wat**: de WUD-store (instellingen, geschiedenis) in ''/volume2/docker/wud2''; de compose staat in Portainer +Categorieën en hun criteria: zie [[homelab:besluiten:26.009-updatebeleid_containers_wud|het updatebeleid]]. AU = ''wud.trigger.docker.autoupdate.enabled=true''. Het getal tussen haakjes is het stacknummer in Portainer. 
-  * **Hoe**: nog vast te leggen (valt de docker-share onder de NVME-backup?)+ 
 +^ 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 ===== ===== Beheer =====
-  * Monitoring: Dozzle voor logs. Loglevel op ''info'' laten (''debug'' alleen tijdelijk) +  * Opzet: versie 9.4.1, eigen stack in Portainer (stack 48), store (instellingen en geschiedenis) in ''/volume2/docker/wud2''. 
-  * Notities: +  * **Handmatig bijwerken**: WUD-UI, tabblad //Containers//, bij de container //Update//. Bij containers met eigen data eerst een back-up. 
-    * Bij problemen met meldingen: eerst de test-trigger in de UI proberen +  * **Container staat op //Cooling down//**: WUD biedt dan mogelijk geen //Update//-knop. Bijwerken via Portainer: //Containers → Recreate// met //Pull latest image version//. 
-    * Open: dubbel WUD-item in de lijst (oude ''docker''-watcher in de store)+  * **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 [[homelab:services:plex|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 [[homelab:standaarden:backups|backupstandaard]]: de store staat op de docker-share (volume 2) en valt onder de NVMe-backup. De compose staat in Portainer. Geen afwijkingen.
  
 ===== Relaties ===== ===== Relaties =====
-  * Gerelateerde besluiten: \\ {{backlinks>.#homelab:besluiten}} +  * Besluiten: \\ {{backlinks>.#homelab:besluiten}} 
-  * Gerelateerde services: \\ {{backlinks>.#homelab:services}} +  * Services: \\ {{backlinks>.#homelab:services}} 
-  * Thema’s: {{tag>container backup}}+  * Thema's: {{tag>container}}
  
homelab/services/wud.1792247238.txt.gz · Last modified: by 127.0.0.1