Chowkidar

Lightweight Docker health monitor with configurable restart and notification actions.

  • Infrastructure
  • Monitoring & Logging
  • Tools & Utilities
Lightweight Docker health monitor with configurable restart and notification actions. Watches containers for unhealthy health events and exited states, then reacts automatically. Supports Discord, Slack, Telegram, ntfy, Gotify, Pushover, email, and plain Apprise URLs.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

54/100 Fair

Maintained
98last commit 18 days ago
Popular
00 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 29 days ago

GitHub stars
0
Open issues
4
Last commit
2026-11-03
Latest release
v0.5.23
License
AGPL-3.0
Activity
steady

Checked 9 days ago - source: GitHub (darkmatterforge/chowkidar)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Setup Deploy the darkmatterforge/chowkidar Docker image and mount the Docker socket (/var/run/docker.sock) so Chowkidar can monitor host containers. source

Fetched 39 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Can I use a custom bash health-check script instead of only Docker’s built-in health check?

Yes, each job can define a bash health-check script where exit 0 means healthy and non-zero means unhealthy. The project also includes dry-run execution and a template picker.

Can Chowkidar monitor containers on more than one Docker host?

It supports multiple Docker hosts or sockets, with each host enabled/disabled individually and given its own monitoring interval, ping timeout, and offline confirm window. Jobs can be pinned to specific Docker contexts, while jobs with no context run on all hosts.

Are notification credentials stored in plain text?

Notification credentials are encrypted at rest using the CHOWKIDAR_SECRET_KEY environment variable.

What authentication does the web UI support?

The web UI supports optional username/password protection with bcrypt hashing.

Can I pause monitoring for jobs or hosts during maintenance windows?

Yes, maintenance windows can target jobs or Docker hosts, but not both for the same window. They support Manual, Single Window, Cron, Interval, Day of Week, and Day of Month strategies, optional date ranges, and control whether queued or in-flight actions are allowed to finish or cancelled.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads