Start Here
Orientation guide for the AORXI homelab documentation: what this site covers, how it is organized, and where to go next.
AORXI is a two-site private cloud built on Proxmox, OPNsense, WireGuard, Netgear 10 Gb switching, and (planned) Kubernetes — documented here so any engineer can understand the full design from first principles without asking anyone.
What This Site Covers
The docs cover every layer of the homelab: physical hardware and cabling, VLAN and IP design, OPNsense and WireGuard configuration, Proxmox cluster setup, Ceph storage at Site B, ZFS and Proxmox Backup Server (PBS) at Site A, DNS, and the Kubernetes/OpenShift plans. Reference pages collect all IP tables, port maps, and decisions in one place.
How to Navigate
| Page | What you will find |
|---|---|
| How It Fits Together | Bird's-eye view of both sites: topology, inter-site link, and how each layer connects |
| Design Principles | The hard architecture rules that cannot be violated and the reasoning behind them |
| Glossary | Every hostname pattern, product name, VLAN name, and acronym used on this site |
Main Documentation Sections
- Architecture — two-site model, site roles, and topology diagrams
- Networking — IP addressing, VLAN reference, WireGuard, DNS, and addressing convention
- Hardware — per-site inventory, NIC allocation, RAM, and storage
- Switching — Site A and Site B port maps, switch roles, and operations
- OPNsense — migration phases and UniFi handoff
- Compute & Storage — Proxmox clusters, ZFS, Ceph, and PBS
- Kubernetes — planning and machine network allocation
- Platform Services — DNS VMs, certificates, Kafka, and container infra
- Operations — IPMI/KVM, build phases, and current build state
- Reference — IP tables, port tables, hardware BOM, and decisions log
AORXI Homelab Docs
Complete reference for the two-site AORXI private cloud: architecture decisions, IP plans, hardware inventory, runbooks, and interactive tools — all in one place.
How It All Fits Together
End-to-end narrative overview of the AORXI homelab: two Proxmox sites, OPNsense edge routing, 10 Gb core switching, WireGuard VPN, VLAN segmentation, storage strategy, and how the build phases connect all the pieces.