wobwobrt/domain-watcher repository overview

⁠Docker Hub — Short Description

(max 100 characters, goes in the "Short Description" field on the repo settings page)

Watches domain whois records and notifies you on registration/registrar/DNS changes.

⁠Docker Hub — Full Description

(goes in the "Full Description" / README field on the repo's Overview tab)

⁠domain-watcher

Polls whois for a list of domains on a schedule and notifies you the moment something changes — registration status, registrar, name servers, expiry date, DNSSEC. Useful for catching unauthorized transfers, expiry surprises, or unexpected DNS changes before they bite.

Domains are grouped by TLD and checked in parallel, each on its own schedule, so throttling requests to one whois server never delays checks for any other TLD.

📖 Full docs, source, and Dockerfile: https://github.com/WobwobRt/domain-watcher⁠

⁠Quick start

docker run -d \
  --name domain-watcher \
  -e DOMAINS="example.com,example.nl,example.org" \
  -e CHECK_INTERVAL=3600 \
  -e NOTIFY_WEBHOOK="https://hooks.slack.com/services/XXX/YYY/ZZZ" \
  -v domain-watcher-data:/data \
  wobwobrt/domain-watcher:latest

Mount /data to persist state across restarts — without it, every restart is treated as a fresh "first check" for every domain and will re-notify.

⁠Configuration

Leave NOTIFY_WEBHOOK empty to disable webhook notifications, or leave NOTIFY_EMAIL_TO/SMTP_HOST unset to disable email.

⁠Signals

Responds to SIGTERM/SIGINT by finishing in-flight checks and shutting down promptly — safe to restart or redeploy without waiting out CHECK_INTERVAL.

Source & issues: https://github.com/WobwobRt/domain-watcher⁠