Files

dtoro f5cd320433 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.

2026-04-28 22:53:09 +02:00

2.0 KiB

Raw Blame History

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 → caddy (121) → 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).
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 stopped publishing to MQTT/REST (commit 82f0596) — HA gets metrics from PVE directly; claudio-monitor focuses on alerting.

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.

2.0 KiB Raw Blame History

108 — haos-16.3