[TUTORIAL] Terraform module for Proxmox SDN: zones, VNets, DHCP, and SNAT

hybridops

New Member
Mar 2, 2026
1
0
1
Built a Terraform module for managing Proxmox SDN declaratively: zone, VNets, subnets, host gateway IPs on the `vnet*` bridges, SNAT/masquerade rules, and dnsmasq DHCP from a single `vnets` map.

The two modes that ended up being most useful in practice:
  • Host-routed: Proxmox owns L3, NAT, and DHCP.
  • Edge-routed: Proxmox SDN handles segmentation while an external edge such as VyOS owns routing and DHCP.

It also supports a few details that mattered in real use:
  • DHCP defaults from subnet CIDRs with per-subnet overrides
  • host-side reconcile without mutating the topology model
  • exported prefix data shaped for NetBox/IPAM workflows
GitHub: https://github.com/hybridops-tech/terraform-proxmox-sdn

Terraform Registry: `hybridops-tech/sdn/proxmox`
 
Last edited: