orochibraru/baba repository overview

⁠Baba

Docs⁠ · Docker Hub⁠ · Releases⁠

Baba is a lightweight homelab monitor that sends Discord or Telegram alerts when something goes wrong — and tells you when it's fixed.

⁠What it does

• Watches CPU usage, system load, memory, disk, CPU/GPU temperature, and GPU utilization
• Alerts via Discord and/or Telegram (multiple notifiers supported)
• Deduplicates: opens an incident only on the Nth consecutive breach — no per-cycle spam
• Recovery alerts: notifies you when a metric returns to normal
• Reminders: re-alerts at a configurable interval while an incident stays open
• Stores full incident history in a local JSON file
• One static binary (about 7 MB, 3 MB gzipped), no runtime or dependencies

⁠Run it

⁠Install script (Linux / macOS)

curl -fsSL https://github.com/orochibraru/baba/releases/latest/download/install.sh | sh
baba setup      # wizard: notifiers and thresholds
baba validate   # send a test alert
baba install    # background service (launchd on macOS, systemd on Linux)

Details in Getting started⁠.

⁠Docker Compose

curl -o config.json https://raw.githubusercontent.com/orochibraru/baba/main/config.example.json
curl -o compose.yaml https://raw.githubusercontent.com/orochibraru/baba/main/compose.example.yaml
# edit config.json: at least one notifier
docker compose up -d

Flags, env-only setup and disks in a container: Docker⁠.

⁠Documentation

• Getting started⁠ and Docker⁠
• Configuration file⁠ and environment variables⁠
• Checks⁠: what's measured, and how, on Linux and macOS
• Notifiers⁠: Discord and Telegram
• Background service⁠, incidents⁠, CLI reference⁠, updates⁠
• Troubleshooting⁠
• Architecture⁠

⁠Contributing

See CONTRIBUTING.md⁠.

⁠License

MIT, see LICENSE⁠.