# Heimdall

Heimdall runs on the Debian host as an always-on Docker Compose service. It is
intentionally outside Kubernetes so the lab navigation dashboard remains
available during cluster rebuilds or outages.

Deploy or refresh it from the Debian server:

```bash
./jeannie deploy-heimdall
```

The default install root is `/data/homelab-heimdall`. Runtime config is stored
under `/data/homelab-heimdall/data/config`, and the dashboard is published on
port `8082` before the OCI edge proxy exposes it as
`https://heimdall.lab2025.duckdns.org/`.

`links.json` is the repo-managed dashboard seed. The sidecar container reruns
`seed-heimdall.py` periodically and upserts links into Heimdall's SQLite
database without deleting manually added tiles.