What's Up Docker? (WUD)

Keep your Docker containers up-to-date, automatically and effortlessly.

📖 Documentation • 🚀 Quick Start • ⚙️ Configuration • 🔔 Triggers • 📦 Registries • 🛠️ Contributing • 💬 Issues & Support

---

• Update base to wud:8.3.1

WUD (What's Up Docker?) is a lightweight, proactive container update monitoring and automation tool. It continuously scans your container environments, detects image updates across public and private registries, performs semantic version analysis, and alerts you via your favorite notification channels—or triggers automatic container updates seamlessly.

flowchart LR
    W["🔍 <b>WATCHERS</b><br/>Discover running containers<br/><i>Local/Remote Docker, Compose, Nomad</i>"]
    WUD{{"⚡ <b>WUD ENGINE</b><br/>Compare versions &amp; digests"}}
    R["📦 <b>REGISTRIES</b><br/>Inspect tags &amp; manifests<br/><i>Docker Hub, GHCR, Private OCI</i>"]
    T["🚀 <b>TRIGGERS</b><br/>Notify &amp; Auto-Update<br/><i>Discord, Slack, Compose, MQTT</i>"]

    W -->|"Scan"| WUD
    WUD <-->|"Inspect"| R
    WUD -->|"Execute"| T

• 🔍 Multi-Watcher Engine
  Monitor local Docker daemons, remote Docker engines over TLS, Docker Compose setups, or HashiCorp Nomad workloads.
• 📦 Multi-Registry Integration
  Zero-config & authenticated support for Docker Hub, GitHub Container Registry (GHCR), AWS ECR, Google GCR/GAR, Azure ACR, Quay, GitLab, Gitea, Forgejo, Codeberg, LinuxServer (LSCR), and any custom/self-hosted OCI registry.
• 🔔 15+ Notification & Automation Triggers
  Get notified or trigger webhooks instantly on Discord, Telegram, Slack, Ntfy, Gotify, Pushover, Apprise, Rocket.Chat, SMTP Email, IFTTT, MQTT (Home Assistant), Apache Kafka, HTTP Webhooks, and Shell Commands.
• 🔄 Automated Container Updates
  Automatically pull new images and recreate containers on demand (Docker, Docker Compose, Nomad).
• 🏷️ SemVer & Tag Filtering
  Flexible versioning strategies: target semver (major, minor, patch), match custom regular expressions, pin versions, or define include/exclude tag rules.
• 🖥️ Interactive Web UI & REST API
  Clean, responsive web dashboard to inspect container statuses, trigger manual update checks, and query data via a full-featured REST API.
• 📊 Prometheus & Grafana Ready
  Built-in Prometheus /metrics endpoint and pre-built Grafana dashboards for observability.
• 🔒 Enterprise-Grade Authentication
  Secure your WUD dashboard with OpenID Connect (OIDC) (Keycloak, Authentik, Authelia, Google, etc.) or HTTP Basic Auth.

docker run -d \
  --name wud \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  getwud/wud:latest

services:
  whatsupdocker:
    image: getwud/wud:latest
    container_name: wud
    ports:
      - "3000:3000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped

🌐 Access the Web UI: Open http://localhost:3000 in your browser.

WUD can be configured globally through environment variables or granularly per container using Docker labels:

services:
  my-app:
    image: myorg/myapp:1.2.0
    labels:
      # Only consider semver minor and patch updates (e.g. 1.2.1, 1.3.0, but not 2.0.0)
      - "wud.tag.include=^1\\.\\d+\\.\\d+$"
      - "wud.tag.transform=^v(.*)$$ => $$1"
      
      # Send update notifications to a specific Discord webhook
      - "wud.trigger.discord.mywebhook.enabled=true"
      
      # Automatically recreate this container when an update is available
      - "wud.trigger.docker.myupdater.enabled=true"

Explore all configuration options in the Configuration Hub.

For complete setup guides, advanced configurations, tutorials, and API references, check out our official documentation:

👉 https://getwud.github.io/wud/

• 🚀 Getting Started & Tutorials
• ⚙️ Configuration Reference
• 🔍 Docker Watcher & TLS
• 📦 Registry Authentication
• 🔔 Triggers & Automation Setup
• 📊 Prometheus & Grafana Monitoring
• 🔌 REST API Reference
• ❓ Frequently Asked Questions (FAQ)

• 🛠️ Want to contribute? Read our Developer & Contributing Guide.
• 🐛 Found a bug or need a feature? Submit an Issue.
• ⭐ Like WUD? Give us a star on GitHub!
• ☕ Support the maintainer: Buy me a coffee or Donate via PayPal.

This project is open-source software licensed under the MIT License.