# RackPeek source of truth

This directory is the git-tracked RackPeek inventory for the homelab.

## Files
- `config.yaml` — current RackPeek v3 inventory assembled from the homelab docs

## Data sources
Update this inventory from the canonical repo docs first:
- `docs/architecture/ARCHITECTURE_OVERVIEW.md`
- `docs/architecture/SERVICES_DIRECTORY.md`
- `docs/architecture/NETWORKING_MODEL.md`
- `docs/servers/PLAUSIBLEDENABILITY.md`
- `docs/servers/SERENITY.md`
- `docs/servers/NOMAD.md`
- `docs/servers/ROCINANTE.md`

For UniFi-managed network gear, refresh from the validated read-only helper after reconciling the docs:
- `automation/bin/unifi_network.py`

## Runtime wiring
The `dev/docker-compose.yaml` RackPeek service mounts this repo directory directly at `/app/config` on PD:
- host path: `/mnt/docker-ssd/docker/compose/dev/rackpeek`
- container path: `/app/config`

Data protection keys remain outside git at:
- `/mnt/tank/docker/appdata/app/rackpeek/dpkeys`

## Validation
From a repo checkout with Docker available:

```bash
docker run --rm \
  -p 18283:8080 \
  -e RPK_YAML_DIR=/app/config \
  -v "$PWD/dev/rackpeek:/app/config" \
  aptacode/rackpeek:latest
```

Then verify:

```bash
curl http://127.0.0.1:18283/health
```

Expected response: `rackpeek`