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.