docker containers die quietly.
get nudged when they do.

A small Go service for single-host Docker setups. It watches the live event stream and sends focused alerts — failure visibility without a full monitoring stack.

           DOCKER HOST · dockerd
  ┌──────────┐  ┌──────────┐  ┌──────────┐
  │ web  ▓▓▓ │  │ api  ▓▓▓ │  │ db   ▒▒░ │
  │ up   ✓   │  │ up   ✓   │  │ OOM  ✗   │
  └────┬─────┘  └────┬─────┘  └────┬─────┘
       └──────┐      │      ┌──────┘
              ▼      ▼      ▼
        ░░░░░ EVENTS STREAM ░░░░░
        die · oom · health · stop
                   │
                   ▼
        ┌──────────────────────┐
        │  ▪ DOCKNUDGE          │
        │  match ▸ dedupe ▸ fan │
        └───────────┬──────────┘
                    │
  ┌──────┬───────┬───┴───┬───────┬──────┐
  ▼      ▼       ▼       ▼       ▼      ▼
slack telegram ntfy   email    sms   gchat
   ░ discord · resend · smtp · +more ░

Single binary · No monitoring stack

01 OOM container killed by the out-of-memory reaper

02 Die non-zero exits, with an ignore list for clean codes

03 Unhealthy health check flips to unhealthy

04 Restart burst n restarts inside a sliding window

05 Unexpected stop stops with no evidence you asked for them

Quick start


      git clone https://github.com/shambu2k/docknudge && cd docknudge
      go build -o docknudge ./cmd/docknudge
      ./docknudge init
      ./docknudge run -c docknudge.yml

License MIT — do what you want, keep the notice.

Config Strict YAML, secrets via ${ENV_VAR} expansion.

View on GitHub

docker containers die quietly.get nudged when they do.

docker containers die quietly.
get nudged when they do.