Know what changed, when it changed, and why things broke — across every node in your homelab.
One timeline. Every node. Zero guesswork when something breaks at 2 AM.
Captures container start, stop, die, create, pull, and delete events per node. Collapses restart loops and attaches crash log tails directly to incidents.
inotify-based watching of .yaml, .yml, .conf, .env, .json, and .ini files. Every change includes a text diff with optional secret redaction.
Weighted cause scoring ranks likely culprits from recent Docker, file, systemd, and update events using event-specific lookback windows and log-snippet bonuses.
Deploy an agent on every machine. All agents report to a single central server. Per-node metadata, live pulse indicators, and cross-node event correlation.
Watches configured systemd units for started, stopped, restart, and failed events. OOM kill detection with journal log snippets for fast triage.
Connect Ollama locally for AI-derived incident summaries and enhanced correlation. AI mode also runs on suspected incidents with full crash log context.
A lightweight agent runs on each node; a central server correlates everything and hosts the UI.
Deploy blackbox-agent on any machine. It monitors Docker, config files, and systemd — then pushes events to the server over a persistent queue that survives network outages.
The central server ingests agent events, Uptime Kuma monitors, and Watchtower updates. It runs the incident engine — grouping outages and scoring probable causes automatically.
A React timeline UI shows every event across every node — filterable by source, node, or text search. Incidents surface the event chain, scored candidates, and optional AI narrative.
Non-root distroless containers. JWT + OIDC auth. Rate limiting. Argon2id password hashing. Read-only agent filesystem. No shell in the server image.
A single docker compose up -d is all it takes to get going.
Copy the config and fill in your secrets. Generate strong tokens with openssl rand -hex 32.
Both containers start. The agent registers with the server and begins watching Docker events and file changes immediately.
The bootstrap wizard walks you through creating your admin account. No manual database setup required — schema migrations run on startup.
Deploy more agents, connect Uptime Kuma webhooks, and optionally configure Ollama for AI analysis — all from the Admin panel.
Open source. Self-hosted. Built for homelabbers.