my-homelab-configs/infra/heimdall/README.md

21 lines
746 B
Markdown

# 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.