Distributed Docker container update manager.
Think Watchtower, but with multi-host support, a real-time dashboard, and centralized control.
WatchWarden monitors Docker containers across multiple hosts, detects available image updates, and applies them with zero-downtime blue-green deployments and automatic rollback on failure.
Solo Mode — drop-in Watchtower replacement. One container, zero dependencies.
Managed Mode — central controller + lightweight Go agents + React dashboard.
| Repo | Description |
|---|---|
| watchwarden | Core: controller (Node.js), agent (Go), UI (React), docs site |
| watchwarden-ha-integration | Home Assistant custom integration |
| watchwarden-custom-card | Home Assistant Lovelace dashboard card |
- Blue-green updates with health-verified zero downtime
- Snapshot rollback to any previous version
- Multi-host management from a single dashboard
- Crash-loop detection with automatic rollback
- Private registry support (Docker Hub, GHCR, ECR, GCR, ACR)
- Notifications via Telegram, Slack, Webhook, ntfy
- API tokens with scoped access for external integrations
- Prometheus metrics endpoint
- Home Assistant integration with sensors, services, and dashboard card
docker run -d \
-v /var/run/docker.sock:/var/run/docker.sock \
-e WW_SCHEDULE="@every 6h" \
-e WW_AUTO_UPDATE=true \
ghcr.io/watchwarden-labs/watchwarden-agent:latest