{"id":20900365,"url":"https://github.com/lkummer/terraform-proxmox","last_synced_at":"2026-03-19T18:02:02.273Z","repository":{"id":132675286,"uuid":"503107760","full_name":"LKummer/terraform-proxmox","owner":"LKummer","description":null,"archived":false,"fork":false,"pushed_at":"2024-01-27T20:53:36.000Z","size":5315,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-19T13:15:20.803Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LKummer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-13T20:38:06.000Z","updated_at":"2022-06-13T23:01:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"9ee52c80-0636-422e-8a53-ce915d0ed17a","html_url":"https://github.com/LKummer/terraform-proxmox","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LKummer%2Fterraform-proxmox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LKummer%2Fterraform-proxmox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LKummer%2Fterraform-proxmox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LKummer%2Fterraform-proxmox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LKummer","download_url":"https://codeload.github.com/LKummer/terraform-proxmox/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243285620,"owners_count":20266849,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-18T11:19:12.130Z","updated_at":"2025-12-26T15:14:03.975Z","avatar_url":"https://github.com/LKummer.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terraform Proxmox Module\n\nTerraform modules for working with Proxmox.\n\nCurrently contains the `machine` module and an example of it.\nProvisioning a virtual machine in Proxmox with autogenerated user name and password.\n\n**IMPORTANT** this repository is push mirrored from my private GitLab.\nChanges on the mirror will be discarded.\n\n## Usage\n\nSee the `examples` folder for full examples.\n\nSee variable descriptions for more information on specific variables.\n\nNote you must have a Proxmox template with Cloud Init to use the `machine` module.\n\n## Development\n\n### Running Tests\n\nSet `PM_API_TOKEN_ID` and `PM_API_TOKEN_SECRET` environment variables with your Proxmox token ID and secret token.\nNote the token ID _must_ contain the username and realm, for example `root@pam!token`.\n\nTo run tests:\n\n```\ncd test\ngo test .\n```\n\nNote it takes a while as it provisions real resources.\n\n### Managing Credentials\n\n[See Proxmox Terraform provider documentation](https://registry.terraform.io/providers/Telmate/proxmox/latest/docs#creating-the-proxmox-user-and-role-for-terraform) on creating a role with privileges for Terraform.\n\nFor instructions on creating a role with correct privileges and creating an API token, [check out this guide on the wiki](https://homelab.pages.houseofkummer.com/wiki/administrate/proxmox-api-tokens/).\n\nIt is recommended to use a `.env` file to manage credentials.\nFor example:\n\n```bash\n# Inside .env\nexport PROXMOX_VE_API_TOKEN='user@pve!token=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'\n```\n\n### Linting\n\nThe repository is linted in CI.\nMake sure to lint before pushing.\n\n```\ntflint --module modules/machine\ntflint examples/alpine-machine\ntflint examples/debian-machine\n```\n\n### Formatting\n\nFormatting is checked in CI.\nMake sure to format code before pushing.\n\n```\nterraform fmt -recursive .\n```\n\n### Linting the Tests\n\nThe tests are linted in CI.\nMake sure to lint before pushing.\n\n```\ncd test\ngolangci-lint run\n```\n\n### Formatting the Tests\n\nTest formatting is checked in CI.\nMake sure to format the tests before pushing.\n\n```\ncd test\ngofmt -w .\n```\n\n## Contribution\n\nThis repository is built for my own needs, not for generic use.\nAdding features for public consumption will make it needlessly complex.\nPlease learn from it and make your own modules instead of contributing new features.\n\nPlease open an issue before working on pull requests.\n\nThis repository is mirroring a private repository, changes to the mirror will be overridden.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flkummer%2Fterraform-proxmox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flkummer%2Fterraform-proxmox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flkummer%2Fterraform-proxmox/lists"}