# Beacon - Complete + Onboarding

$300 one-time. All eleven, plus a 1:1 session.

## What this is

A working, pinned Docker Compose stack for self-hosted observability. Not a
link dump - the integration layer: services wired together, environment
template, quickstart, runbook, and a script that fetches the exact upstream
sources at pinned commits.

## Included

- All eleven components
- 1:1 onboarding session
- Lifetime updates

## Components

| Component | Licence | Language | Role |
|---|---|---|---|
| prometheus | Apache-2.0 | Go | Metrics collection and storage |
| alertmanager | Apache-2.0 | Go | Alert routing and deduplication |
| VictoriaMetrics | Apache-2.0 | Go | Long-term metrics storage |
| thanos | Apache-2.0 | Go | Long-term Prometheus at scale |
| fluent-bit | Apache-2.0 | C | Log collection and forwarding |
| opentelemetry-collector | Apache-2.0 | Go | Telemetry pipeline (metrics, logs, traces) |
| jaeger | Apache-2.0 | Go | Distributed tracing |
| uptime-kuma | MIT | JavaScript | Uptime monitoring |
| upptime | MIT | Markdown | Status page from GitHub Actions |
| superset | Apache-2.0 | Python | Dashboards and BI |
| opentelemetry-js | Apache-2.0 | TypeScript | Instrumentation SDK for Node |

## Quickstart

```bash
cp .env.example .env
docker compose up -d
./verify.sh
```

Endpoints:
- `prometheus` -> http://localhost:9090
- `alertmanager` -> http://localhost:9093
- `victoriametrics` -> http://localhost:8428
- `thanos` -> http://localhost:10902
- `fluentbit` -> http://localhost:2020
- `otel` -> http://localhost:4317
- `jaeger` -> http://localhost:16686
- `uptimekuma` -> http://localhost:3001
- `superset` -> http://localhost:8088

Upptime and the OpenTelemetry JS SDK are not services - see `docs/`.

## Getting the sources

```bash
./fetch-sources.sh ./sources
```

All components are MIT or Apache-2.0. See `ATTRIBUTION.md`.

## Requirements

- Docker Engine 24+ with the Compose v2 plugin
- 4 GB RAM for the metrics tier, 8 GB with logs, 16 GB+ for traces at scale

## Support

See `RUNBOOK.md`.