wud v0.1.0

Dev tools

WUD (What's Up Docker) — watches your running Docker containers for available image updates and can notify or auto-update them, with a clean web UI and 30+ triggers. Deployed as a single host-networked Nomad service.

nomad-pack run wud --registry nomploy

…or one line (add registry + run)

curl -fsSL https://packs.nomploy.com/install.sh | sh -s -- wud

Needs nomad-pack on PATH. The script only adds the nomploy registry and runs this pack.

Source ↗ Project ↗ ★ 4k ⚑ Report an issue

1 task http 3000 image getwud/wud:latest tracks :latest image bumped today

Variables 10

values.hcl

Save as values.hcl, edit, then run:

nomad-pack run wud -f values.hcl --registry nomploy

# The name of the Nomad job.
job_name = "wud"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The WUD container image. Pin a tag in production.
image = "getwud/wud:latest"

# Host port for the WUD web UI.
port = 3000

# Web UI admin username.
admin_user = "admin"

# Web UI admin password. CHANGE THIS.
admin_password = "wud_change_me"

# Host path to the Docker socket to watch. Bind-mounted read-only.
docker_sock = "/var/run/docker.sock"

# Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true". Pin to the node whose containers you want watched.
constraints = []

# The task resources.
resources = {
    cpu    = 200
    memory = 256
  }

Name	Type	Default	Description
job_name	string	"wud"	The name of the Nomad job.
namespace	string	"default"	The Nomad namespace to deploy into.
datacenters	list	["*"]	The datacenters to deploy to.
image	string	"getwud/wud:latest"	The WUD container image. Pin a tag in production.
port	number	3000	Host port for the WUD web UI.
admin_user	string	"admin"	Web UI admin username.
admin_password set me	string	"wud_change_me"	Web UI admin password. CHANGE THIS.
docker_sock	string	"/var/run/docker.sock"	Host path to the Docker socket to watch. Bind-mounted read-only.
constraints	list	[]	Placement constraints. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true". Pin to the node whose containers you want watched.
resources	object	{ cpu = 200 memory = 256 }	The task resources.

Readme

wud

WUD (What's Up Docker) keeps an eye on your running Docker containers and tells you when a newer image is available. It inspects tags and manifests across Docker Hub, GHCR, ECR, GCR/GAR, ACR, Quay, GitLab, Gitea/Forgejo and any OCI registry, shows everything in a clean web UI, and can fire 30+ triggers (Discord, Slack, MQTT, email, webhooks…) or even auto-update containers.

This pack runs WUD as a single host-networked Nomad service.

Deploy

nomad-pack run wud --registry=nomploy \
  --var admin_password=$(openssl rand -hex 12)

Open http://<node-ip>:3000 and log in.

Configuration

Variable	Default	Description
`image`	`getwud/wud:latest`	Container image (pin a tag in production).
`port`	`3000`	Host port for the web UI.
`admin_user`	`admin`	Web UI admin username.
`admin_password`	`wud_change_me`	Web UI admin password — change this.
`docker_sock`	`/var/run/docker.sock`	Docker socket to watch (mounted read-only).
`resources`	200 MHz / 256 MB	CPU and memory for the task.

WUD watches the Docker socket of the node it runs on — pin it there with constraints. Add notification and auto-update behaviour via WUD_TRIGGER_* and WUD_WATCHER_* environment variables.