wiki-vault/Wiki/Homelab/proxmox.md
Travis Herbranson 7eb8d756d1 compile: first compile — 17 entities, 2 synthesis, all indexes rebuilt
Read all 62 source files (Dev: 37, Homelab: 22, Venture: 3, Reference: 0).

Entity pages created (17):
- Wiki/Reference: lovebug, jenny, sunnie, n8n, ob1, tailscale, authentik,
  traefik, cloudflare, obsidian, gitea, plant-based-southerner, claude-code,
  dispatch, docker
- Wiki/Homelab: proxmox
- Wiki/Dev: pbs-hub, herbydev

Synthesis pages created (2):
- Wiki/Homelab/homelab-ingress-stack — four-layer ingress model (Cloudflare +
  Traefik + Authentik + Tailscale); operational lessons from 10+ source files
- Wiki/Dev/ai-memory-architecture — three memory layers (wiki + OB1 + Dispatch
  context); ingest paths; harness-vs-model design decision

All 11 index pages rebuilt (Sources/Dev, Venture, Homelab, Reference, Sources
root; Wiki/Dev, Venture, Homelab, Reference, Wiki root; vault root index.md).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-08 18:15:31 -04:00

51 lines
2.4 KiB
Markdown

---
type: entity
path: Wiki/Homelab
tags:
- proxmox
- homelab
created: 2026-05-08
updated: 2026-05-08
---
# Proxmox
## What it is
Proxmox VE is the bare-metal hypervisor running in the homelab, hosting virtual machines and LXC containers for all homelab services. It provides the compute substrate under Authentik, DNS stack (Knot + Pi-hole), OB1 (Supabase + pgvector), the GitHub Actions self-hosted runner (ustest1), and future services. Proxmox's VM/LXC flexibility allows mixing full VMs (for services needing kernel isolation) with lightweight LXCs (for simpler services).
## Current state
Active. Key guests running on Proxmox:
- **ustest1** — Self-hosted GitHub Actions runner for PBS CI/CD (`pbsii-cicd-pipeline`)
- **DNS stack** — Knot DNS primary + secondary, Pi-hole (split-horizon `.herbylab.dev`)
- **Authentik** — SSO/IdP for homelab services
- **OB1** — Supabase + pgvector memory system (deployment in progress)
- **herbydev** — Primary dev workstation VM (promoted from us-test-authy)
VLAN scheme renumbered in May 2026: VID 11 (lab network), VID 21 (private network); OpenWrt switch chip aligned to bridge VID assignment.
## Where it lives
- Physical homelab hardware (specific host/model not documented in sources)
- Managed via Proxmox web UI and CLI
- Network: OpenWrt VLAN-segmented switch, VLANs 11/21
## Related projects
- [[Sources/Homelab/ob1-main-deployment|ob1-main-deployment]] — OB1 Supabase on Proxmox
- [[Sources/Dev/herbys-dev-setup|herbys-dev-setup]] — herbydev VM setup
- [[Sources/Dev/pbsii-cicd-pipeline|pbsii-cicd-pipeline]] — ustest1 GitHub Actions runner
- [[Sources/Homelab/dns-knot-pihole-end-to-end|dns-knot-pihole-end-to-end]] — DNS stack on Proxmox
- [[Sources/Homelab/2026-05-08-homelab-vlan-renumber-switch-chip-to-bridge-alignment|2026-05-08-homelab-vlan-renumber-switch-chip-to-bridge-alignment]] — VLAN renumber
- [[Sources/Homelab/homelab-mcp-server|homelab-mcp-server]] — MCP server (Proxmox-hosted)
- [[Wiki/Homelab/homelab-ingress-stack|homelab-ingress-stack]] — synthesis
## History
- Ongoing — Core homelab compute platform
- **2026** — DNS stack deployed: Knot DNS + Pi-hole chain live
- **2026** — herbydev promoted from us-test-authy (Proxmox VM rename/reconfigure)
- **2026-05-06** — MCP server deployed on Proxmox behind Authentik + Cloudflare Tunnel
- **2026-05-08** — VLAN scheme renumbered (VID 11 lab, VID 21 private); switch chip → bridge alignment fixed