Skip to content

hybridops-terraform-gitmods

Git-sourced Terraform modules for Proxmox VM and LXC lifecycle. Consumed via Git source references and also published to the Terraform Registry under hybridops-studio.

Requirements: Terraform >= 1.5.0 · bpg/proxmox >= 0.50.0 · Proxmox VE 8.x

Source: github.com/hybridops-tech/hybridops-terraform-gitmods

Module Registry Purpose
proxmox/vm hybridops-studio/vm/proxmox Single Proxmox VM from template; Linux (cloud-init) and Windows; multi-NIC
proxmox/vm-multi hybridops-studio/vm-multi/proxmox Homogeneous VM group (wraps vm)
proxmox/lxc hybridops-studio/lxc/proxmox Single LXC container for high-density stateless services

Sourcing via Git

module "platform_vm" {
  source = "git::https://github.com/hybridops-tech/hybridops-terraform-gitmods.git//proxmox/vm?ref=v1.0.0"
  # ...
}

Pin to a release tag. HybridOps.Core packs reference these modules at a fixed ?ref= tag; upgrade by bumping the tag in the pack inputs.

Linux vs. Windows networking

Linux guests use cloud-init for static IP and hostname configuration. Windows guests do not support cloud-init networking: static IP must be applied post-provisioning or via DHCP reservation. NIC ordering is deterministic: interfaces are addressed in the order defined in the network_interfaces input.