Bootstrap Homelab-Docs wiki

Initial documentation of the hubris Proxmox homelab as a cross-linked
markdown wiki. Per-node pages, cross-cutting infrastructure pages, an
investigation log, and an operations cheatsheet. Each node and topic
ends with a Changelog section so changes can be tracked in-place going
forward.

Refreshed against live state on 2026-04-28 — 14 active LXCs (109
syncthing currently stopped) + 1 VM (108 haos). Reflects post-A/B-test
state of the 2026-04-21 hubris crash-loop investigation.

vms/108-haos.md

@@ -0,0 +1,44 @@
+# 108 — `haos-16.3`
+
+Home Assistant OS — the only VM on hubris (HAOS doesn't run cleanly in an LXC, hence the qm tenant).
+
+## At a glance
+- **Type:** QEMU VM
+- **HAOS version:** 16.3 (last verified)
+- **IP:** `192.168.8.101`
+- **Resources:** 4 GiB RAM, 32 GiB boot disk
+- **Public hostname:** [`home.hubris.network`](../infrastructure/dns.md) → [caddy (121)](121-caddy.md) → `192.168.8.101:8123`
+
+## Auth
+
+Native OIDC via the HACS integration `christiaangoossens/hass-oidc-auth` (repo `https://github.com/christiaangoossens/hass-oidc-auth`).
+
+Key gotchas:
+- HAOS containers don't honor the Network-panel DNS. Set Supervisor DNS via:
+  ```
+  ha dns options --servers "dns://192.168.8.180" --servers "dns://1.1.1.1"
+  ```
+  so OIDC discovery resolves internally to [authentik (124)](124-authentik.md).
+- Authentik app slug in the discovery URL is whatever was set in Authentik — confirm via the DB rather than guessing. User set `home-assistant` (with hyphen).
+- YAML config:
+  - `features.automatic_user_linking: true` — link to existing HA users by `preferred_username` match (otherwise a duplicate is created).
+  - `features.default_redirect: true` — skip the welcome-splash so users land on the normal HA login page.
+- Run `ha core restart` after each config change — HA caches DNS and OIDC discovery across frontend reloads.
+
+## Telemetry
+
+HA pulls Proxmox metrics via the official Proxmox VE integration. As of 2026-04-21 [claudio-monitor](../infrastructure/monitoring.md) stopped publishing to MQTT/REST (commit `82f0596`) — HA gets metrics from PVE directly; claudio-monitor focuses on alerting.
+
+## Related
+- [Authentik (124)](124-authentik.md)
+- [Caddy (121)](121-caddy.md)
+- [DNS](../infrastructure/dns.md)
+- [Monitoring](../infrastructure/monitoring.md)
+
+## Changelog
+
+### 2026-04-28 — wiki entry created
+Initial documentation.
+
+### 2026-04-21 — wired into Authentik via HACS hass-oidc-auth
+Supervisor DNS pointed at LXC 124 dnsmasq; YAML features for auto-linking + default redirect.