🚀 Proxmox VM Deployment Automation with OpenTofu and Ansible

This project provides a comprehensive solution for automating the deployment and configuration of virtual machines on a Proxmox VE cluster, using OpenTofu (an open-source fork of Terraform) for infrastructure management and Ansible for post-deployment configuration and NAT rule management.

📖 Documentation

• Features
• Technologies Used
• Deployment Flow
• Project Structure
• Configuration
• Usage
• Configuration File
• Connecting to VMs
• OpenFaaS Integration
• Testing
• Troubleshooting
• Notes on Git History Rewriting
• References

🖥️ Optional Web Dashboard

A lightweight dashboard is bundled in webapp/ if you prefer to follow deployments from the browser:

1. Install requirements (ideally inside a virtualenv): pip install -r requirements-test.txt.
2. Start the server: python webapp/app.py (customise the port by exporting DEPLOY_UI_PORT).
3. Open http://localhost:5000 to launch or destroy the stack.

The UI mirrors the Terraform/Ansible workflow, showing live logs and a card for each phase. Cards for Docker or K3s only appear when those roles are defined in terraform.tfvars, so the dashboard always matches the roles that will actually run.