Proxmox & Linstor HCI Automated Provisioning

This repository contains an Infrastructure as Code (IaC) pipeline to automatically bootstrap a Highly Available Proxmox Virtual Environment (PVE) cluster, with an optional High Availability Hyperconverged Linstor/DRBD storage stack.

🚀 Quick Start (For Beginners)

You do not need to install Ansible locally. This repository includes a DevContainer pre-configured with all necessary tools, linters, and extensions.

1. Install Visual Studio Code and Docker (or Podman).
2. Install the VS Code Dev Containers Extension.
3. Clone this repository and open the folder in VS Code.
4. Click "Reopen in Container" when prompted in the bottom right corner (or press Ctrl+Shift+P and type Dev Containers: Reopen in Container).
5. Proceed to the Documentation to configure your cluster variables and run your first deployment.

📚 Documentation

Detailed documentation is available in the docs/ directory. If you are new to Ansible or this stack, please read them in order:

• 01 - Prerequisites & Node Preparation
• 02 - Configuring the Cluster (Inventory & Vars)
• 03 - Running the Playbook
• 04 - Architecture & Phase Breakdown
• 05 - Linstor & Storage Deep Dive
• 06 - Troubleshooting & FAQ