Canonical source: This wiki topic is the living source of truth for the PFVCluster project overview. Updated in place; edit history preserves all prior states.
Source repo: PFVCluster on Gitea
Work tracking: Redmine — Technology & Facility Services (project id 55)
PFVCluster
Unified infrastructure repo for the Known Element Enterprises Proxmox R&D cluster.
Architecture at a Glance
| Component | Details |
|---|---|
| Proxmox hosts | 7 standalone PVE installs managed via PDM |
| DNS | Technitium (authoritative) + Pi-hole (recursive) on pfv-netinfra-01/02 |
| NTP | pfv-netinfra-01/02 (redundant, LAN IPs, stratum 2/3) |
| Production | Cloudron VPS in Reston VA (this cluster is R&D only) |
| Backups | Proxmox Backup Server (PBS) |
| k8s | k3s HA control plane (currently DOWN — rebuild pending) |
| Config management | KNELIAC (Ansible) |
| Automation | AWX 24.6.1 on k3s |
| Storage | tsys4 (NFS: D1/D2/D3/D5 + /mnt/albert + /mnt/backup), tsys5 (NFS: S1/S2 + local SSD + NVMe) |
Directory Structure
| Directory | Description |
|---|---|
dcinfra/ |
Data-center infrastructure: PDU (powerman/), serial console (console/), UPS (ups/) |
netinfra/ |
DNS/NTP/DHCP setup + audit scripts, DNS cluster replication, switch captures, DHCP config |
k8s/ |
k3s cluster setup scripts (HA control plane over Tailscale) + co-located docs |
proxmox/ |
Proxmox fleet docs (hardware audit, capacity, storage, k8s host planning) + performance tuning |
awx/ |
Ansible AWX deployment (k3s + AWX Operator) |
tests/ |
Test suite + VM validation harness + remote.sh SSH chokepoint |
docs/ |
Server-build docs, documentation index |
archive/ |
Historical/superseded code (provisioning → replaced by KNELIAC project) |
vendor/ |
Vendored KNELShellFramework |
Quick Start
Provision a new server
sudo bash provisioning/SetupNewSystem.sh
Validate on the sandbox VM
VM_ID=6000 ./tests/vm-validation.sh all
Deploy DNS cluster
cd dns-cluster-setup/ && ./setup.sh all
Deploy perf tunings
cd perf/ && ./deploy-tuning.sh
Related Topics
- Operations Status — ticket index + infrastructure summary (pinned)
- Infrastructure Audit Log — point-in-time audit snapshots
- Proxmox Fleet Reference — per-host reference, VM inventory, capacity
- Network Topology — full network reference with topology diagrams
- Storage Architecture — storage tiers, disk inventory, NFS exports
- Kubernetes Platform — k8s architecture and decisions