Introduction
Proxmox VE Helper Scripts is a community-driven collection of Bash scripts that automate the provisioning of LXC containers and virtual machines on Proxmox VE. Each script handles OS selection, resource allocation, networking, and application installation in a single interactive command.
What Proxmox VE Helper Scripts Does
- Provides ready-to-run scripts for hundreds of self-hosted applications
- Automates LXC container creation with sensible defaults
- Handles VM provisioning with disk, CPU, and memory configuration
- Supports both interactive and non-interactive (default settings) modes
- Includes update scripts to keep deployed containers current
Architecture Overview
Each script is a standalone Bash file that calls the Proxmox VE API via the pvesh and pct command-line tools. Scripts follow a common template: they prompt for configuration options, create the container or VM, install the target application, and configure networking. A shared library of helper functions handles common operations like storage selection and OS template downloads.
Self-Hosting & Configuration
- Requires a running Proxmox VE host with shell access
- No additional dependencies beyond standard Proxmox VE tools
- Scripts are fetched directly from the project website at runtime
- Each script can be customized by editing variables before execution
- Works with Proxmox VE 7.x and 8.x
Key Features
- Covers a wide range of applications from Home Assistant to databases
- Scripts are individually maintained and tested by the community
- Minimal footprint — each container uses only the resources the app needs
- Consistent interface across all scripts for a predictable experience
- Active development with frequent additions of new application scripts
Comparison with Similar Tools
- Ansible — general-purpose automation; these scripts are Proxmox-specific and require no Ansible knowledge
- Terraform — declarative infra-as-code; these scripts are imperative and interactive
- Docker Compose — container orchestration; these scripts create full LXC containers, not Docker containers
- tteck/Proxmox — the original project this community edition forked from and continues to maintain
FAQ
Q: Do I need to install anything on my Proxmox host first? A: No. The scripts use tools already present on a standard Proxmox VE installation.
Q: Can I run these scripts on a remote machine? A: They must be run directly on the Proxmox VE host or via SSH to the host.
Q: Are the containers production-ready? A: They provide a solid starting point. Review security settings and resource limits for production use.
Q: How do I update an application deployed by a script? A: Many scripts include a companion update script. Check the project documentation for your specific app.