proxmox_bootstrap_tool
Proxmox VE 9 Node Bootstrap Framework
A modular, TUI-driven automation framework for standardizing the deployment and optimization of Proxmox VE 9 (Trixie) nodes — engineered to align with SRE workflows and replace deprecated monolithic scripts with a scalable, maintainable solution.
🚀 Quick Deploy
Run the following command directly in your Proxmox shell to launch the TUI installer. Recommended for fresh Proxmox 9.x installations.
bash -c "$(wget -qLO - https://raw.githubusercontent.com/alwazw/proxmox_bootstrap_tool/main/setup.sh)"
🛠 Engineering Principles
1. Hybrid Bootloader Abstraction (UEFI vs. BIOS)
The framework includes intelligent boot environment detection to ensure architectural compatibility across modern and legacy hardware:
- UEFI / systemd-boot — Detects
/sys/firmware/efiand a ZFS-on-Root configuration, then automates kernel parameter injection viaproxmox-boot-tool refresh. - Legacy BIOS / GRUB — Falls back to
/etc/default/gruborchestration withupdate-grubexecution hooks when EFI firmware is absent.
2. DEB822 Repository Standardization
Proxmox 9 adopts the DEB822 multi-line specification for package management. This framework automates migration from legacy .list files to modern .sources stanzas:
| Objective | Implementation |
|---|---|
| System Idempotency | Prevents redundant entries and configuration drift |
| Optimized Mirrors | Precise selection of No-Subscription and Ceph-Squid repositories |
| Cryptographic Security | GPG keyring management under /etc/apt/keyrings/ per current best practices |
3. Modular Architecture
The framework is structured into discrete, decoupled logic components for extensibility:
proxmox_bootstrap_tool/
├── lib/ # Shared hardware abstraction layers & UI helper functions
├── modules/ # Decoupled task logic (IOMMU passthrough, microcode updates, user provisioning)
└── setup.sh # Primary orchestrator — manages whiptail interface lifecycle & process flow
📦 Manual Installation
For environments requiring local inspection or manual control:
git clone https://github.com/alwazw/proxmox_bootstrap_tool
cd proxmox_bootstrap_tool
chmod +x setup.sh
./setup.sh
📅 Roadmap
Active development is underway to evolve this tool into a comprehensive Infrastructure-as-Code (IaC) enabler.
- Ansible Orchestration Module — Dynamic inventory generator and playbooks for large-scale cluster management
- Terraform & OpenTofu Integration — Declarative VM deployment via API user provisioning and RBAC automation
- Security Hardening (CIS Compliance) — SSH key-based auth enforcement and
fail2banintegration for the Proxmox admin interface - Automated Cluster Convergence — Streamlined node integration into existing clusters via secure API token authentication
🤝 Contributing
Contributions that enhance SRE operational efficiency or expand hardware compatibility are welcome. Please adhere to the abstraction patterns established in the root directory when submitting pull requests.