dtoro
c012a9124f
Reformatted the ludo-mini workstation to Proxmox VE 9.2.3 and joined it to hubris's existing single-node "Homelab" cluster (2 nodes, no QDevice yet). Added a second NVMe as its own LVM-thin pool (ludo-lvm). Renamed the wiki/inventory identity from ludo-mini to strong to match the OS/ cluster hostname, since bootstrap's client-enrollment lookup depends on that match. Also regenerated hosts/grimmory.yaml, which was missing from git despite being referenced by inventory.yaml. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
78 lines
5.0 KiB
Markdown
78 lines
5.0 KiB
Markdown
# Homelab Wiki — `hubris`
|
|
|
|
Living documentation for the **hubris** Proxmox homelab. Every node, every cross-cutting system, and every meaningful incident is its own page; pages are linked so you can start anywhere and walk the graph.
|
|
|
|
> Last refreshed against live state: **2026-04-28**.
|
|
|
|
## Map
|
|
|
|
### Hosts
|
|
- [`hubris`](hosts/hubris.md) — Proxmox VE node, GMKtec NucBox M6 Ultra, `192.168.8.77` — runs everything today
|
|
- [`strong`](hosts/strong.md) — Proxmox VE node (cluster hostname `strong`), `192.168.178.181` — 2nd member of the `Homelab` cluster as of 2026-07-01, hosts no guests yet
|
|
|
|
### VMs
|
|
- [100 — `zimaos`](vms/100-zimaos.md) — ZimaOS 1.6.1, NAS frontend (evaluation)
|
|
- [108 — `haos-16.3`](vms/108-haos.md) — Home Assistant OS
|
|
|
|
### LXC containers
|
|
See the full table in [`containers/index.md`](containers/index.md). Quick links:
|
|
|
|
| ID | Name | IP | Role |
|
|
| --- | ---------------- | --------------- | --------------------------------------------- |
|
|
| 101 | [jellyfin](containers/101-jellyfin.md) | 192.168.8.206 | Media server |
|
|
| 102 | [nfs-export](containers/102-nfs-export.md) | 192.168.8.200 | NFSv4 re-export of /mnt/library for ZimaOS |
|
|
| 103 | [paperless](containers/103-paperless.md) | 192.168.8.130 | Document mgmt |
|
|
| 104 | [gitea](containers/104-gitea.md) | 192.168.8.121 | Git server |
|
|
| 105 | [apps](containers/105-apps.md) | 192.168.8.205 | Docker host (Artifacto / PlantUML / Portainer / WriteFreely) |
|
|
| 114 | [nextcloud](containers/114-nextcloud.md) | 192.168.8.224 | Personal cloud |
|
|
| 118 | [elementsynapse](containers/118-elementsynapse.md) | 192.168.8.239 | Matrix Synapse |
|
|
| 119 | [sophia](containers/119-sophia.md) | 192.168.8.157 | Sophia |
|
|
| 120 | [mule-images](containers/120-mule-images.md) | 192.168.8.136 | Mule-image / mulita photos |
|
|
| 121 | [caddy](containers/121-caddy.md) | 192.168.8.175 | Reverse proxy |
|
|
| 122 | [arriman](containers/122-arriman.md) | 192.168.8.132 | Docker host (\*arr stack) |
|
|
| 124 | [authentik](containers/124-authentik.md) | 192.168.8.180 | SSO + split-horizon DNS |
|
|
| 130 | [grimmory](containers/130-grimmory.md) | 192.168.8.213 | Digital library (Grimmory — fork of Booklore) |
|
|
|
|
### Cross-cutting infrastructure
|
|
- [DNS — split-horizon](infrastructure/dns.md)
|
|
- [Ingress — Caddy + VPS traefik](infrastructure/ingress.md)
|
|
- [Mesh — Tailscale → Netbird migration](infrastructure/mesh.md)
|
|
- [Monitoring — Hermes health watchdog](infrastructure/monitoring.md)
|
|
- [Media permissions — `media` GID 10000](infrastructure/media-permissions.md)
|
|
- [SSH access](infrastructure/ssh-access.md)
|
|
- [Backups — restic on external drive (disabled)](infrastructure/backups.md)
|
|
- [Auto-deploy — gitea-webhook pipelines](infrastructure/auto-deploy.md)
|
|
- [VPS hardening — IONOS / netbird control plane](infrastructure/vps-hardening.md)
|
|
- [Homelab context distribution](infrastructure/homelab-context.md) — cross-client `/opt/homelab-context` + MCP + secrets-issuance
|
|
|
|
### Investigations
|
|
Time-stamped incident notes / experiments in [`investigations/`](investigations/index.md).
|
|
|
|
### Operations
|
|
- [Command cheatsheet](operations/commands.md)
|
|
- [Agent enrollment](operations/agent-enrollment.md) — bootstrap a new client (workstation, LXC, VM) into the homelab context system
|
|
|
|
## Conventions
|
|
|
|
- **Each node page** ends with a `## Changelog` section. Reverse-chronological. Entry format:
|
|
```
|
|
### YYYY-MM-DD — short title
|
|
one or two lines on what changed and why.
|
|
```
|
|
- **Cross-linking is mandatory.** If a page references another node or system, link to it. Treat orphans as a bug.
|
|
- **Live state wins.** When something here disagrees with `pct config` / `docker inspect` / running config, fix the wiki *and* note the change in the relevant changelog.
|
|
- **Tracked configs.** A node whose config lives in a Gitea repo (Caddy, Gitea customizations, Artifacto, mule-image) is auto-deployed via webhook — see [auto-deploy](infrastructure/auto-deploy.md). Edits there must be pushed, not left local.
|
|
- **No secrets.** This is a private repo on `git.hubris.network`, but still: paths to secret files are fine, secret values are not.
|
|
|
|
## Maintaining this wiki
|
|
|
|
When you change a node:
|
|
1. Update the relevant page (config snapshot, ports, mounts).
|
|
2. Add a changelog entry at the bottom of that page.
|
|
3. If the change touches a cross-cutting system (DNS, Caddy, Authentik, mesh), update *that* page too and link it from the changelog entry.
|
|
4. If it's an incident, add an entry to [`investigations/`](investigations/index.md).
|
|
|
|
## See also
|
|
|
|
- [`CONTRIBUTING.md`](CONTRIBUTING.md) — page templates and tone
|