![\"Buy](\"https://cdn.buymeacoffee.com/buttons/default-orange.png\")
\n\nA [Pulumi](https://www.pulumi.com) package to manage [Proxmox Virtual Environment](http://proxmox.com) (Proxmox VE) resources. This provider is built on the [Terraform Proxmox Provider](https://github.com/bpg/terraform-provider-proxmox).\n\n## Installation\n\nThis package is available for multiple programming languages. Install using your preferred package manager:\n\n### Node.js (JavaScript/TypeScript)\n\n```bash\nnpm install @muhlba91/pulumi-proxmoxve\n# or\nyarn add @muhlba91/pulumi-proxmoxve\n```\n\n### Python\n\n```bash\npip install pulumi-proxmoxve\n```\n\n### Go\n\n```bash\ngo get github.com/muhlba91/pulumi-proxmoxve/sdk/v6/go/proxmoxve\n```\n\n### .NET\n\n```bash\ndotnet add package Pulumi.ProxmoxVE\n```\n\n## Configuration\n\nYou must configure the provider with your Proxmox VE API credentials. Currently, you must explicitly pass configuration values to the provider constructor. You can use environment variables to manage these secrets:\n\n| Variable | Description |\n|------------------------|-----------------------------------------------------------------------------------|\n| `PROXMOX_VE_ENDPOINT` | The API endpoint of your Proxmox VE server (e.g., `https://pve.example.com:8006`) |\n| `PROXMOX_VE_USERNAME` | Your Proxmox VE username |\n| `PROXMOX_VE_PASSWORD` | Your Proxmox VE password or API token |\n| `PROXMOX_VE_INSECURE` | Set to `true` to skip TLS certificate verification |\n\n## Example Usage\n\n### TypeScript\n\n```typescript\nimport * as pulumi from '@pulumi/pulumi';\nimport * as proxmox from '@muhlba91/pulumi-proxmoxve';\n\n// Initialize the Proxmox provider\nconst provider = new proxmox.Provider('proxmoxve', {\n endpoint: process.env.PROXMOX_VE_ENDPOINT,\n username: process.env.PROXMOX_VE_USERNAME,\n password: process.env.PROXMOX_VE_PASSWORD,\n insecure: process.env.PROXMOX_VE_INSECURE === 'true',\n});\n\n// Create a Virtual Machine\nconst vm = new proxmox.vm.VirtualMachine('my-vm', {\n nodeName: 'pve-node-1',\n // ... further configuration\n}, { provider });\n```\n\n## Migration\n\n### v7 to v8 (Breaking Changes)\n\nVersion 8 introduces a breaking change in how resources are named to align with the upstream Terraform provider's transition to the modern provider framework.\n\n- **Standardized Resource Names**: Due to the upstream provider introducing the `proxmox_` prefix and standardizing resource identification, custom resource name and ID changes have been deprecated.\n- **Legacy Namespacing**: Resources that previously started with `proxmox_virtual_environment_` have been moved to a `Legacy` naming format (e.g., `proxmoxve:VM/virtualMachine:VirtualMachine` is now `proxmoxve:index/vmLegacy:VmLegacy`).\n- **Standardized Resource IDs**: Resources which have an `id` input exposed by the Terraform provider are consistently renamed to `resourceId`. In particular, this affects resources created using the Terraform provider framework.\n\n#### State Migration\n\nYou can migrate your existing stack by exporting the state, updating the resource tokens, and re-importing:\n\n```bash\npulumi stack export > stack.json\n# Example: updating the VirtualMachine resource token\nsed -i 's/proxmoxve:VM\\/virtualMachine:VirtualMachine/proxmoxve:index\\/vmLegacy:VmLegacy/g' stack.json\npulumi stack import < stack.json\n```\n\n#### ID Migration\n\nFor resources that have an `id` input, you will need to update your code to use `resourceId` instead. For example:\n\n```typescript\n// Example: updating a Vnet resource to use resourceId instead of id\n\n// Before\nconst vnet = new proxmox.sdn.Vnet('my-vnet', {\n vnetId: '1',\n // ... further configuration\n});\n\n// After\nconst vnet = new proxmox.sdn.Vnet('my-vnet', {\n resourceId: '1',\n // ... further configuration\n});\n```\n\n## Reference\n\n- **Upstream Provider Reference**: [Terraform Proxmox Provider Documentation](https://registry.terraform.io/providers/bpg/proxmox/latest/docs)\n- **Proxmox API**: [Proxmox VE API Viewer](https://pve.proxmox.com/pve-docs/api-viewer/index.html)\n- **Official Documentation**: [Proxmox VE Documentation](https://pve.proxmox.com/pve-docs/)\n\n## Contributors\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\n\n\n![\"Daniel](\"https://avatars.githubusercontent.com/u/653739?v=4?s=100\") Daniel Mühlbachler-Pietrzykowski 🚧 💻 📖 | \n ![\"Nelson](\"https://avatars.githubusercontent.com/u/11583533?v=4?s=100\") Nelson Costa Martins 💡 | \n ![\"Guinevere](\"https://avatars.githubusercontent.com/u/13116240?v=4?s=100\") Guinevere Saenger 📖 | \n ![\"Susan](\"https://avatars.githubusercontent.com/u/5489125?v=4?s=100\") Susan Evans 📖 | \n ![\"zamrih\"/](\"https://avatars.githubusercontent.com/u/1061718?v=4?s=100\") zamrih 💻 | \n