Start Here
Get a single-node install running, complete first-time setup, and understand the core Blackbox model.
What these docs cover
- Docker, file watcher, systemd, and webhook data sources
- Timeline entries, incidents, correlation, and optional AI analysis
- OIDC, notifications, MCP, API docs, and operational troubleshooting
Start paths
Choose the job you need to do
The docs are organized around common operator and contributor tasks instead of mirroring the repository one-to-one.
Deploy And Operate
Run one central server, scale out to multiple nodes, and keep data sources, persistence, and troubleshooting clear.
Build And Contribute
Set up a development environment, understand the repo layout, and add new source types without guessing.