mrcharles
4f82520e0e
Root cause of Uptime Kuma DNS up/down alerts: Pi-hole's upstream config included Google IPv6 DNS (2001:4860:4860::8888), but netinfra-01 has no IPv6 internet route. Every forwarded query to the IPv6 upstream failed with "Network unreachable", causing intermittent DNS resolution failures every ~8 seconds. Fix applied to both netinfra-01 and netinfra-02: - Pi-hole upstream set to 8.8.8.8 only (IPv4); removed 192.168.3.16 (retired netboot) and 2001:4860:4860::8888 (IPv6 Google DNS) - IPv6 disabled at kernel level (/etc/sysctl.d/99-disable-ipv6.conf) - knel.net authoritative resolution unchanged (Technitium via revServers) Verified: zero IPv6 warnings, zero connection errors, DNS resolving cleanly from all paths after fix. [#376]
PFVCluster
Unified infrastructure repo for the Known Element Enterprises Proxmox R&D cluster.
→ Current Status · → Documentation Index · → Agent Guidelines
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 (dns-cluster-setup/), switch captures (switches/), DHCP config (dhcp/) |
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 (perf/) |
awx/ |
Ansible AWX deployment (k3s + AWX Operator) |
tests/ |
Test suite + VM validation harness + remote.sh SSH chokepoint |
docs/ |
Server-build docs, documentation index (docmap), and archive |
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
Architecture
- 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)