From 0d2093ba3b2703d20fde6a0233cfa95ed6862e45 Mon Sep 17 00:00:00 2001 From: dtoro Date: Mon, 6 Jul 2026 18:38:29 +0200 Subject: [PATCH] docs: replace hardcoded infra details in README with pointers to index pages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Problem: README listed specific IPs, container IDs, and per-host counts (e.g. "hubris (15 active): 102 nfs-export, 103 paperless..."). This duplicates inventory.yaml and the wiki index pages, and goes stale every time a node moves, gets added, or is destroyed — exactly what happened during the strong migration. Fix: Replaced the Proxmox Hosts / VMs / LXC Containers / Cross-Cutting Infrastructure subsections with plain pointers to their authoritative index pages (knowledge/wiki/{hosts,vms,containers,infrastructure}/index.md). Also dropped the "Last refreshed against live state" date line — another claim that goes stale without a mechanism to keep it honest. README's job is navigation, not a live topology snapshot. Co-Authored-By: Claude Opus 4.8 --- README.md | 35 +++++------------------------------ 1 file changed, 5 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index 7428f18..8c369f6 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,6 @@ Living documentation for the **hubris** Proxmox homelab + Oikos operating system **For agents running on enrolled clients:** start with [AGENTS.md](AGENTS.md), then [OIKOS.md](.agents/OIKOS.md). -> Last refreshed against live state: **2026-07-06**. - --- ## For Agents — Navigation & Entry Points @@ -157,35 +155,12 @@ The narrative documentation is organized in **layers**: ### Topology & Infrastructure -#### Proxmox Hosts -- [`hubris`](knowledge/wiki/hosts/hubris.md) — PVE node (primary), `192.168.8.77` — runs [15 containers + 2 VMs](knowledge/wiki/containers/index.md) -- [`strong`](knowledge/wiki/hosts/strong.md) — PVE node (cluster member), `192.168.178.181` — hosts [7 containers](knowledge/wiki/containers/index.md) +Node counts, IPs, and service lists change often — treat `inventory.yaml` and the index pages below as the source of truth, not this README. -#### VMs -- [100 — `zimaos`](knowledge/wiki/vms/100-zimaos.md) — ZimaOS (NAS frontend, evaluation) -- [108 — `haos-16.3`](knowledge/wiki/vms/108-haos.md) — Home Assistant OS -- See [vms/index.md](knowledge/wiki/vms/index.md) for the full table - -#### LXC Containers -See the full table with IPs, hosts, mounts, and status in -[`containers/index.md`](knowledge/wiki/containers/index.md). Quick summary: - -- **hubris** (15 active): 102 nfs-export, 103 paperless, 104 gitea, 105 apps, 114 nextcloud, 119 sophia, 120 mule-images, 121 caddy, 124 authentik, 128 trmnl, 132 rclone -- **strong** (7 active): 101 jellyfin, 118 elementsynapse, 122 arriman, 129 house, 130 grimmory, 133 seanime, 134 romm -- **Destroyed (archaeology)**: [see containers/index.md](knowledge/wiki/containers/index.md#recently-destroyed-kept-for-archaeology) - -#### Cross-Cutting Infrastructure -- [Infrastructure index](knowledge/wiki/infrastructure/index.md) — map of every cross-cutting system -- [DNS — split-horizon](knowledge/wiki/infrastructure/dns.md) -- [Ingress — Caddy + VPS traefik](knowledge/wiki/infrastructure/ingress.md) -- [Mesh — Tailscale → Netbird migration](knowledge/wiki/infrastructure/mesh.md) -- [Monitoring — Hermes health watchdog](knowledge/wiki/infrastructure/monitoring.md) -- [Media permissions — `media` GID 10000](knowledge/wiki/infrastructure/media-permissions.md) -- [SSH access](knowledge/wiki/infrastructure/ssh-access.md) -- [Backups — rclone → Proton Drive (LXC 132)](knowledge/wiki/infrastructure/backups.md) -- [Auto-deploy — gitea-webhook pipelines](knowledge/wiki/infrastructure/auto-deploy.md) -- [VPS hardening — IONOS / netbird](knowledge/wiki/infrastructure/vps-hardening.md) -- [Homelab context distribution — cross-client provisioning + MCP + secrets](knowledge/wiki/infrastructure/homelab-context.md) +- **Proxmox hosts** → [knowledge/wiki/hosts/index.md](knowledge/wiki/hosts/index.md) +- **VMs** → [knowledge/wiki/vms/index.md](knowledge/wiki/vms/index.md) +- **LXC containers** → [knowledge/wiki/containers/index.md](knowledge/wiki/containers/index.md) +- **Cross-cutting infrastructure** (DNS, ingress, mesh, backups, monitoring, auto-deploy, VPS) → [knowledge/wiki/infrastructure/index.md](knowledge/wiki/infrastructure/index.md) ### Knowledge & References