Baba

Docs · Docker Hub · Releases

Named after the lookout pirate in the French comic book Astérix, always watching for trouble on the horizon.

Caution

While the app's version is more than 1.x it's still in beta and may contain bugs. It won't impact your system but I can't guarantee it's reliable yet until I have long term data to prove it.

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.