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.9 KiB

Raw Blame History

Operations cheatsheet

Run from the hubris host as root. When working from /root on Linux you're already on hubris — don't ssh hubris / ping hubris.

Proxmox CLI

Command	Use
`pct list` / `qm list`	List LXC containers / VMs
`pct config <id>` / `qm config <id>`	Container / VM config
`pct exec <id> -- <cmd>`	Run command inside an LXC without entering it (no initgroups — see media permissions)
`pct enter <id>`	Shell into a container
`pct start <id>` / `pct stop <id>`	Boot / halt a container
`pvesm status`	Storage pools status
`pvesh get /nodes --output-format json`	Node summary as JSON
`pvesh get /nodes/hubris/lxc/<id>/status/current`	Live container status
`pvesh get /cluster/resources --type vm --output-format json`	Bulk per-LXC CPU/mem/disk (used by claudio-monitor)
`pveversion`	PVE version
`journalctl -u pve-cluster -n 100`	PVE service logs

Storage

Shared mount: /mnt/library (ext4 on lvmthin library).
Bind into a container: pct set <id> -mp<N> /mnt/library/<sub>,mp=/data
For the standard whole-tree mount: pct set <id> -mp0 /mnt/library,mp=/mnt/library. See media permissions for the GID-10000 onboarding recipe.

Reverse proxy

Caddyfile: /etc/caddy/Caddyfile on LXC 121. Tracked in dtoro/caddy-conf. Edits should be committed + pushed — see auto-deploy.
Hot reload: pct exec 121 -- systemctl reload caddy.
Validate: pct exec 121 -- caddy validate --config /etc/caddy/Caddyfile.

DNS

Split-horizon entries: /etc/dnsmasq.d/hubris-split.conf on LXC 124. Hard restart on edit: pct exec 124 -- systemctl restart dnsmasq. SIGHUP isn't reliable.
Verify: dig @192.168.8.180 +short <host>.hubris.network.
See DNS.

Web access

https://proxmox.hubris.network or https://192.168.8.77:8006 — Proxmox UI

Telemetry quick checks

ras-mc-ctl --summary — summary of any RAS events (memory / PCIe AER / thermal) since boot
ras-mc-ctl --errors — full event log
cat /sys/devices/system/cpu/cpu0/cpufreq/energy_performance_preference — should be balance_power
cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor — should be powersave
ls /sys/fs/pstore/ /var/lib/systemd/pstore/ — panic traces from a previous crash (empty for pure hardware hangs — see investigation)

2.9 KiB Raw Blame History