Event-driven, in-memory Docker container update manager.
While tools like Watchtower or standard Docker Compose are great for starting containers, Dockwatch acts as an intelligent CI/CD automation pipeline that sits on top of them.
Instead of relying on slow cron-based polling, Dockwatch bridges the gap between your CI/CD (like GitHub Actions) and your production servers, acting as an event-driven webhook receiver to instantly deploy updates with zero delay.
Deploy Dockwatch using Docker Compose. Make sure to mount the Docker socket so Dockwatch can interact with your containers!
services:
dockwatch:
image: soerja/dockwatch:latest
container_name: dockwatch
restart: unless-stopped
ports:
- "3010:3010"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- ./data:/data
environment:
- DOCKWATCH_WEBHOOK_SECRET=your_super_secret_key
Once running, open http://localhost:3010 in your browser to access the dashboard.
By default, Dockwatch watches all containers on the docker socket. To explicitly target or ignore a specific container, add these Docker labels to your target application:
services:
myapp:
image: myrepo/myapp:latest
labels:
- "dockwatch.watch=true"
- "dockwatch.update=auto"
| Label | Values | Description |
|---|---|---|
dockwatch.watch | true / false | Include this container (default: all) |
dockwatch.update | auto / minor / patch / notify | Update strategy |
dockwatch.health.grace | duration (e.g., 60s) | Override health grace window |
dockwatch.compose.update | auto / notify | Enable AST YAML compose-first update path |
Configure Dockwatch by passing these environment variables to the container:
| Variable | Default | Description |
|---|---|---|
DOCKWATCH_ADDR | :3010 | HTTP listen address for Webhooks/UI |
DOCKWATCH_LOG_LEVEL | info | Log verbosity: debug/info/warn/error |
DOCKWATCH_WEBHOOK_SECRET | "" | HMAC-SHA256 secret for validating /webhook/push payloads |
DOCKWATCH_HISTORY_DB | /data/dockwatch.db | SQLite database path for update history |
DOCKWATCH_HISTORY_DIR | /data/history | Directory for compose file backups (rollback snapshots) |
DOCKWATCH_HEALTH_GRACE | 30s | How long to watch a container post-update |
DOCKWATCH_DRY_RUN | false | Disable all destructive actions |
DOCKWATCH_AGENT_TOKEN | "" | Shared token for authenticating remote agents |
For full documentation on how to configure your GitHub Actions or Docker Hub webhooks to trigger Dockwatch, please visit the official GitHub repository:
Source Code & Docs: https://github.com/soerjadi/dockwatch
Content type
Image
Digest
sha256:9c66d98cd…
Size
32.5 MB
Last updated
4 months ago
docker pull soerja/dockwatch