---
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