KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

proxmox-tf-modules

★ 37 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Repository containing Terraform/OpenTofu modules for provisioning infrastructure on Proxmox

Current list of modules:
- [k3s](modules/k3s/)
  - [basic example deployment using this module](examples/k3s-basic-deployment/)
  - [example deployment using this module with the haproxy-lb to configure a HA TCP loadbalancer for the kube api](examples/k3s-with-load-balancer-deployment/)
- [haproxy-lb](modules/haproxy-lb/)
  - [basic example deployment using this module](examples/haproxy-lb-basic-deployment/)
- [generic-vm](modules/generic-vm/)

Additional modules and examples will be added over time.

## How to get started using these modules

- Install terraform or opentofu
- Create a git repo to house your IaC deployments. Can be in github, gitlab, your own private git server, etc
- Copy example deployment for module you want to use into your new deployment repo
- Update example input variables for your environment specific settings. proxmox creds, node names, IP addresses, etc
- Set `source` for copied configuration to reference a tag from the public git repo instead of the local reference used for testing. example: `source = git::https://github.com/jbmay/proxmox-tf-modules.git//modules/k3s?ref=v0.1.1`
- Run `terraform/tofu init` to init your backend and download modules
- Run `terraform/tofu apply` to apply the configuration
- Run `terraform/tofu destroy` to destroy the deployed infrastructure
- Read the README and variables.tf for the module for configuration notes, limitations, known issues, and additional variables not set in the example deployment
- Push your working deployment to your remote repo and consider setting up cicd to handle your infrastructure deployments for you. Be sure to not store anything sensitive in git. It is recommended to add state and auto.tfvars files to .gitignore so they aren't accidentally committed with sensitive values

# Proxmox version 7 and older
Users that still run Proxmox versions 7 and older [read about known issues and workarounds here related to the bpg provider depending on API updates made in Proxmox 8.x](./docs/proxmox_7_limitations.md).

proxmox-tf-modules

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README