# Chowkidar

Chowkidar is a self-hosted infrastructure app. Lightweight Docker health monitor with configurable restart and notification actions. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2263/chowkidar

## Description

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.

## Health score

54/100 (Fair), based on 3 of 4 factors.
- Maintained: 98 (last commit 18 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/darkmatterforge/chowkidar
- GitHub: https://github.com/darkmatterforge/chowkidar
- Unraid: https://ca.unraid.net/apps/chowkidar-0zmunr0000ptsw?q=chowkidar

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/2263/chowkidar), the self-hosted and open-source app directory.
