HUB
Sign inSign up

soerja/dockwatch

By soerja

•Updated 4 months ago

Image
Integration & delivery
Developer tools
0

299

soerja/dockwatch repository overview

⁠🐳 Dockwatch

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.


⁠⚡ Quick Start

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.


⁠🏷️ Container Labels

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"
LabelValuesDescription
dockwatch.watchtrue / falseInclude this container (default: all)
dockwatch.updateauto / minor / patch / notifyUpdate strategy
dockwatch.health.graceduration (e.g., 60s)Override health grace window
dockwatch.compose.updateauto / notifyEnable AST YAML compose-first update path

⁠⚙️ Environment Variables

Configure Dockwatch by passing these environment variables to the container:

VariableDefaultDescription
DOCKWATCH_ADDR:3010HTTP listen address for Webhooks/UI
DOCKWATCH_LOG_LEVELinfoLog verbosity: debug/info/warn/error
DOCKWATCH_WEBHOOK_SECRET""HMAC-SHA256 secret for validating /webhook/push payloads
DOCKWATCH_HISTORY_DB/data/dockwatch.dbSQLite database path for update history
DOCKWATCH_HISTORY_DIR/data/historyDirectory for compose file backups (rollback snapshots)
DOCKWATCH_HEALTH_GRACE30sHow long to watch a container post-update
DOCKWATCH_DRY_RUNfalseDisable all destructive actions
DOCKWATCH_AGENT_TOKEN""Shared token for authenticating remote agents

⁠🔗 Documentation & Source Code

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⁠

Tag summary

Content type

Image

Digest

sha256:9c66d98cd…

Size

32.5 MB

Last updated

4 months ago

docker pull soerja/dockwatch