my-homelab-configs/infra/heimdall
juvdiaz acc88d1ca6 Heimdall seeds 2026-07-02 16:56:56 -06:00
..
README.md Moving heimdall outside k8s 2026-07-02 15:49:00 -06:00
docker-compose.yml Moving heimdall outside k8s 2026-07-02 15:49:00 -06:00
links.json Heimdall seeds 2026-07-02 16:56:56 -06:00
seed-heimdall.py Moving heimdall outside k8s 2026-07-02 15:49:00 -06:00

README.md

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.