upstream/terraform-provider-proxmox
1
0
Fork 0
mirror of https://github.com/Telmate/terraform-provider-proxmox.git synced 2025-12-18 14:36:05 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
Terraform Provider - Proxmox VE
1205 commits 6 branches 49 tags 3.1 MiB
Go 99.4%
Makefile 0.6%
Find a file
Okean 93f843646a
Some checks failed
Go / verify-dependencies (push) Has been cancelled
Details
Go / build (push) Has been cancelled
Details
Go / vet (push) Has been cancelled
Details
Go / staticcheck (push) Has been cancelled
Details
Go / test (push) Has been cancelled
Details
Merge pull request #1473 from Tinyblargon/bump-dep-1 
chore: bump proxmox-api-go
2025-12-16 23:39:32 +01:00
.github ci: update go version 2025-05-22 23:07:47 +02:00
docs docs: fix only spelled as ony 2025-11-28 23:19:28 +01:00
proxmox fix disk schema to accept ide3 as a valid slot 2025-12-04 03:43:10 +01:00
.gitignore chore: ignore debug binary 2025-01-28 08:18:25 +01:00
.goreleaser.yml Update v0 syntax 2024-06-09 20:54:10 +02:00
go.mod chore: bump proxmox-api-go 2025-12-16 23:36:09 +01:00
go.sum chore: bump proxmox-api-go 2025-12-16 23:36:09 +01:00
go.yml docs: New developer getting started guide (#888) 2024-01-02 11:56:44 +01:00
LICENSE initial commit 2017-02-08 20:53:24 -08:00
main.go Fix Go module name (#790) (#791) 2023-12-06 11:48:14 +01:00
Makefile fix makefile 2024-01-21 11:43:02 +01:00
README.md add validation to vm_qemu name field (#858) 2023-12-06 12:23:37 +01:00

README.md

Build Status

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.

Getting Started

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.

Quick Start

Follow this install guide to install the plugin.

Known Limitations

  • proxmox_vm_qemu.disk.size attribute does not match what is displayed in the Proxmox UI.
  • Updates to proxmox_vm_qemu resources almost always result as a failed task within the Proxmox UI. This appears to be harmless and the desired configuration changes do get applied.
  • When using the proxmox_lxc resource, the provider will crash unless rootfs is defined.
  • When using the Network Boot mode (PXE), a valid NIC must be defined for the VM, and the boot order must specify network first.

Contributing

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 --debug.

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

Useful links