> The lookout. Watches CPU, load, memory, disk, temps and GPU, then pings Discord or Telegram when something breaks, and again when it heals.
> Source: https://orochibraru.com/baba/canary/docs · Site index: https://orochibraru.com/llms.txt

# Baba documentation

The lookout. Watches CPU, load, memory, disk, temps and GPU, then pings Discord or Telegram when something breaks, and again when it heals.

The Markdown in [the project repo](https://github.com/orochibraru/baba/tree/main/docs) is the source of truth;
these pages are generated from it.

- [Baba](https://orochibraru.com/baba/canary/docs/readme.md): Docs · Docker Hub · Releases
- [Contributing](https://orochibraru.com/baba/canary/docs/contributing.md): Prerequisites. Running locally. Tests. Adding a notifier. Release process.
- [Getting started](https://orochibraru.com/baba/canary/docs/getting-started.md): Install baba on a Linux or macOS server, point it at Discord or Telegram, and leave it running.
- [Docker](https://orochibraru.com/baba/canary/docs/docker.md): The orochibraru/baba image (linux/amd64 and linux/arm64) runs baba start and checks its own health with baba health. It needs to see the host, not the…
- [Configuration file](https://orochibraru.com/baba/canary/docs/config.md): All settings below live in config.json (/var/lib/baba/config.json, or --config, or BABA_CONFIG_PATH). Unknown fields are ignored, so check the spelling of every…
- [Environment Variables](https://orochibraru.com/baba/canary/docs/env.md): Every setting in config.json can be overridden with an environment variable. Values are applied before validation, so type coercion and defaults still apply.
- [Checks](https://orochibraru.com/baba/canary/docs/checks.md): Every intervalSeconds, baba reads each enabled check once, one after the other, and logs a status line:
- [Notifiers](https://orochibraru.com/baba/canary/docs/notifiers.md): notifiers in config.json is the only required setting: a list of places to send alerts. List several, of either type; every alert goes to all of them.
- [Background service](https://orochibraru.com/baba/canary/docs/service.md): baba install registers /usr/local/bin/baba start as a service that starts on its own and restarts on crash. It needs /var/lib/baba/config.json, so run baba…
- [Incidents](https://orochibraru.com/baba/canary/docs/incidents.md): baba doesn't alert on every high reading. It opens an incident once a metric has breached its threshold enough times in a row, reminds you while it lasts, and…
- [CLI reference](https://orochibraru.com/baba/canary/docs/commands.md): Flags go before or after arguments, with one or two dashes (-config and --config are the same). Every command exits with 1 and prints baba: <error> on stderr…
- [Updates](https://orochibraru.com/baba/canary/docs/updates.md): Asks GitHub for the latest stable release. When it's newer than the running version, it downloads baba-<os>-<arch>.gz, and swaps it in place of the running…
- [Troubleshooting](https://orochibraru.com/baba/canary/docs/troubleshooting.md): Start with baba health: it names the part that's broken. logLevel: "debug" (or BABA_LOG_LEVEL=debug) logs every reading, breach count and incident decision.
- [Architecture](https://orochibraru.com/baba/canary/docs/architecture.md): baba is one Go binary built from the standard library only: no modules, no cgo, no runtime to install. It was a Bun app until its binaries grew too big; the Go…