# bpg/terraform-provider-proxmox

Terraform / OpenTofu Provider for Proxmox VE

Repository: https://github.com/bpg/terraform-provider-proxmox
Canonical: https://ross.abutalabs.com/products/bpg-terraform-provider-proxmox
Homepage: https://bpg.sh/docs/
Language: Go
License: MPL-2.0
License Family: copyleft
Topics: terraform-provider, proxmox, opentofu, terraform
Last push: 2026-08-25T21:58:24+00:00

## Health v2 (maintenance only)
Score: 92/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 79, longevity 100
- inputs: {"age_days": 1821, "days_push": 8, "days_rel": 61, "gap_med": 7.0, "n_releases_24m": 73}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2199, forks 309 (observed 2026-08-28T04:06:25.466250+00:00)

## What it is
A Terraform and OpenTofu provider that enables declarative management of Proxmox Virtual Environment resources such as VMs, containers, storage, users, and ACLs. It is an actively maintained fork of the unmaintained danitso provider, supporting Proxmox VE 8.x/9.x with API token, ticket, and password authentication.

## Use cases
- provision proxmox vms with terraform
- manage proxmox cluster as code
- clone vm templates in proxmox via opentofu
- automate proxmox lxc container creation
- configure cloud-init for proxmox vms
- manage proxmox users roles and acls with terraform
- download cloud images and create vms in proxmox

## When to choose
- you use Terraform or OpenTofu and want declarative, version-controlled Proxmox infrastructure
- you need to automate VM/container lifecycle, cloning, and cloud-init setup on Proxmox VE 8.x or 9.x
- you want CI/CD-friendly API token authentication and importable existing resources

## When to avoid
- you run Proxmox VE 7.x, which is unsupported
- you need guaranteed backward compatibility between minor releases while the provider is on 0.x
- you use a different hypervisor such as VMware, libvirt, or a public cloud

## Facets
- artifact type: plugin
- maturity: active
- function: infrastructure-as-code, configuration-management, deployment, cloud
- domain: infrastructure-as-code, cloud-computing, self-hosted
- platform: go, cross-platform, cli, self-hosted
- tags: terraform-provider, opentofu, proxmox-ve, iac, vm-provisioning, cloud-init, qemu-kvm, virtualization, devops

## Member repositories
- bpg/terraform-provider-proxmox (main) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:25.466250+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:47:07.041439+00:00, confidence not recorded.
  - readme: https://github.com/bpg/terraform-provider-proxmox (fetched 2026-08-28T04:06:25.466250+00:00, sha 8f5ac66734c8)
  - homepage: https://bpg.sh/docs/ (fetched 2026-08-29T10:27:22.970622+00:00, sha d42ee532367c)
  - site_page: https://bpg.sh/docs/guides/clone-vm (fetched 2026-08-29T10:27:22.980282+00:00, sha d99e054a2a33)
  - site_page: https://bpg.sh/docs/resources/acl (fetched 2026-08-29T10:27:22.982092+00:00, sha 43b8001d8422)
  - site_page: https://bpg.sh/docs/data-sources/acme_account (fetched 2026-08-29T10:27:22.983691+00:00, sha caab951d150b)
  - site_page: https://bpg.sh/docs/guides/cloned-vm (fetched 2026-08-29T10:27:22.985206+00:00, sha 767eade94360)
  - site_page: https://bpg.sh/docs/guides/migration-vm-clone (fetched 2026-08-29T10:27:22.986922+00:00, sha 48a18ac7505e)
  - site_page: https://bpg.sh/docs/guides/cloud-init (fetched 2026-08-29T10:27:22.988815+00:00, sha 4a64831e9a37)
  - site_page: https://bpg.sh/docs/guides/cloud-image (fetched 2026-08-29T10:27:22.990353+00:00, sha d9e60aef7520)
  - site_page: https://bpg.sh/docs/guides/dev-proxmox-setup (fetched 2026-08-29T10:27:22.991837+00:00, sha afc712517c0a)
- Data as of 2026-08-30T08:39:29.467469+00:00.