Repolode
Submit
getwud

getwud/wud

A self-hosted tool that watches running containers across Docker, Swarm, Kubernetes, Compose and Nomad, flags newer image versions, and can notify or auto-update them.

Open-source alternative to:Watchtower

View on GitHubWebsite
Stars
4,191
Forks
163
Open issues
64
Last commit
23 hours ago

What is it?

What's Up Docker (WUD) scans the containers running in your environment and checks their registries for newer image versions. It compares tags and digests, applies semantic versioning rules and tag filters, and then notifies you through chat, push, messaging or automation channels. Where supported, it can also pull the new image and recreate the container.

WUD covers standalone Docker hosts (local socket or remote TLS), Docker Compose projects, Docker Swarm services and stacks, Kubernetes Deployments, StatefulSets, DaemonSets and CronJobs, and Nomad jobs. Registry support includes Docker Hub, GHCR, AWS ECR, Google GCR and Artifact Registry, Azure ACR, Quay, GitLab, and self-hosted OCI registries.

It includes a web dashboard, a REST API, a Prometheus metrics endpoint, and role-based access control with local accounts or OpenID Connect single sign-on. A one-shot CLI mode runs a single scan without a server or database, which suits CI pipelines and cron jobs.

Key features

  • 01Watches Docker, Swarm, Kubernetes, Compose and Nomad workloads for newer image versions.
  • 02Supports Docker Hub, GHCR, AWS ECR, Google, Azure, Quay, GitLab and self-hosted OCI registries.
  • 03Sends notifications to dozens of channels including Discord, Slack, Telegram, Ntfy and SMTP email.
  • 04Filters tags with semver rules, regular expressions and include/exclude patterns.
  • 05Can automatically pull images and recreate Docker, Compose or Nomad containers.
  • 06Offers a web dashboard, REST API, and Prometheus metrics endpoint.

Use cases

  • Keeping self-hosted homelab services on Docker or Compose current with update alerts.
  • Getting notified in chat when a Kubernetes Deployment has a newer image available.
  • Gating a CI/CD pipeline on whether any monitored container has an update pending.
  • Enforcing semver-only upgrades on production containers through tag rules.

Quick start

  1. 1

    Run WUD as a Docker container

    docker run -d --name wud -p 3000:3000 -e WUD_AUTH_ADMIN_USER="admin" -e WUD_AUTH_ADMIN_PASSWORD="MySecurePassword123" -v /var/run/docker.sock:/var/run/docker.sock getwud/wud:latest
  2. 2

    Or run it with Docker Compose using the README's YAML file

  3. 3

    Open the web UI at http://localhost:3000 and log in

Things to know

  • The examples use a default admin password, so change it before exposing the dashboard.
  • Watching the local Docker host requires mounting the Docker socket, which grants broad host control.

In collections

Self-hosted apps

Topics

#docker#container-updates#kubernetes#image-monitoring#semver#self-hosted#devops#nodejs#update-checker

FAQ

What is wud?
A self-hosted tool that watches running containers across Docker, Swarm, Kubernetes, Compose and Nomad, flags newer image versions, and can notify or auto-update them. What's Up Docker (WUD) scans the containers running in your environment and checks their registries for newer image versions. It compares tags and digests, applies semantic versioning rules and tag filters, and then notifies you through chat, push, messaging or automation channels. Where supported, it can also pull the new image and recreate the container.
Is wud free to use? What license does it have?
wud is open source under the MIT license. Check the license terms before using it in commercial products.
Is wud still maintained?
Actively maintained. The last commit to wud was on Nov 6, 2026.
What can I use wud for?
Keeping self-hosted homelab services on Docker or Compose current with update alerts. Getting notified in chat when a Kubernetes Deployment has a newer image available. Gating a CI/CD pipeline on whether any monitored container has an update pending. Enforcing semver-only upgrades on production containers through tag rules.
How do I install wud?
Run WUD as a Docker container: docker run -d --name wud -p 3000:3000 -e WUD_AUTH_ADMIN_USER="admin" -e WUD_AUTH_ADMIN_PASSWORD="MySecurePassword123" -v /var/run/docker.sock:/var/run/docker.sock getwud/wud:latest Or run it with Docker Compose using the README's YAML file Open the web UI at http://localhost:3000 and log in
Where can I get wud?
The source code and installation instructions are on GitHub: https://github.com/getwud/wud

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects