> For the complete documentation index, see [llms.txt](https://www.trentbauer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.trentbauer.com/homelab/service-overviews/maintenance-and-monitoring/blackbox.md).

# Blackbox

{% embed url="<https://github.com/maxjb-xyz/blackbox>" %}

**An intelligent self-hosted forensic event timeline for homelabs and home servers.**\
**Know&#x20;*****what*****&#x20;changed,&#x20;*****when*****&#x20;it changed, and&#x20;*****why*****&#x20;things broke.**

Blackbox is a lightweight, self-hosted event correlation platform built for homelabbers who want to understand their infrastructure at a glance. It collects events from Docker, config file changes, selected systemd units, uptime monitors, and container update tools, correlates them into a single chronological timeline, and groups likely outages into incidents with scored cause candidates and optional local-AI analysis or AI-enhanced correlation.

When your homelab breaks, Blackbox tells you what happened. You don't need to lift a finger.

## Blackbox Server

{% @github-files/github-code-block url="<https://github.com/trentnbauer/HomelabPublic/blob/main/docker-compose/blackbox-server.yml>" %}

## Beszel Agent

{% hint style="info" %}
The agent is deployed as part of the ['All' stack](/homelab/service-overviews/docker/all-stack.md)
{% endhint %}