Terraform provider plugin for Proxmox
This repository provides a Terraform provider for the Proxmox virtualization platform and exposes Terraform resources to provision QEMU VMs and LXC Containers.
In order to get started, use the documentation included in this repository. The documentation contains a list of the options for the provider. Moreover, there are some guides available how to combine options and start specific VMs.
Follow this install guide to install the plugin.
sizeattribute does not match what is displayed in the Proxmox UI.
- Updates to
proxmox_vm_qemuresources almost always result as a failed task within the Proxmox UI. This appears to be harmless and the desired configuration changes do get applied.
proxmox_vm_qemudoes not (yet) validate vm names, be sure to only use alphanumeric and dashes otherwise you may get an opaque 400 Parameter Verification failed (indicating a bad value was sent to proxmox).
- When using the
proxmox_lxcresource, the provider will crash unless
- When using the Network Boot mode (PXE), a valid NIC must be defined for the VM, and the boot order must specify network first.
When contributing, please also add documentation to help other users.
Debugging the provider
Debugging is available for this provider through the Terraform Plugin SDK versions 2.0.0. Therefore, the plugin can be
started with the debugging flag
For example (using delve as Debugger):
dlv exec --headless ./terraform-provider-my-provider -- --debug
For more information about debugging a provider please see: Debugger-Based Debugging