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

746 B

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:

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