# Proxmox VE Helper Scripts — One-Command LXC and VM Setup for Proxmox

> A community-maintained collection of shell scripts that automate creating, configuring, and managing LXC containers and VMs on Proxmox VE with a single command.

## Install

Save in your project root:

# Proxmox VE Helper Scripts — One-Command LXC and VM Setup for Proxmox

## Quick Use
```bash
# Example: create a Docker LXC container
bash -c "$(curl -fsSL https://community-scripts.github.io/ProxmoxVE/scripts/ct/docker.sh)"

# Example: create an Ubuntu VM
bash -c "$(curl -fsSL https://community-scripts.github.io/ProxmoxVE/scripts/vm/ubuntu.sh)"
```

## Introduction
Proxmox VE Helper Scripts is a community-driven collection of Bash scripts that reduce Proxmox VE setup from hours to minutes. Each script handles the full lifecycle of creating an LXC container or VM for a specific application, including storage allocation, network configuration, and initial software installation.

## What Proxmox VE Helper Scripts Does
- Provides one-command deployment for 200+ popular applications as LXC containers
- Automates VM creation with pre-configured templates for common operating systems
- Handles storage selection, resource allocation, and network bridge configuration interactively
- Includes update and maintenance scripts for keeping deployed containers current
- Offers both default and advanced modes for quick setup or fine-tuned control

## Architecture Overview
Each script is a self-contained Bash file that sources shared utility functions for Proxmox API interaction, user prompts, and error handling. Scripts call the ``pct`` and ``qm`` CLI tools directly to create containers and VMs, then use SSH or ``lxc-attach`` to configure the guest OS and install target software.

## Self-Hosting & Configuration
- Requires Proxmox VE 7.x or 8.x with shell access to the host node
- Scripts run directly on the Proxmox host; no additional software needed
- Each script prompts for container ID, hostname, disk size, CPU cores, and RAM
- Advanced mode exposes options for VLAN tags, DNS settings, and privilege levels
- Post-install scripts available for updating or reconfiguring existing containers

## Key Features
- Covers 200+ applications from Home Assistant to Plex to Nextcloud to databases
- Community maintained with frequent additions for new applications
- Consistent UX across all scripts with color-coded output and validation
- Both LXC container and full VM scripts available
- Minimal footprint: no agent or daemon installed on the Proxmox host

## Comparison with Similar Tools
- **Proxmox built-in templates** — limited to OS images; helper scripts install and configure applications
- **Ansible for Proxmox** — more flexible but requires Ansible knowledge; helper scripts are zero-dependency
- **Terraform Proxmox provider** — infrastructure-as-code approach; helper scripts are interactive and immediate
- **tteck scripts (original)** — predecessor project; community edition continues active maintenance
- **Docker Compose on Proxmox** — container-level; helper scripts manage Proxmox-native LXC and VM resources

## FAQ
**Q: Are these scripts safe to run on a production Proxmox host?**
A: They only use official Proxmox CLI tools and do not modify host configuration. Review each script before running in production.

**Q: Can I customize resource allocations?**
A: Yes. Advanced mode lets you override every parameter including disk, CPU, RAM, and network settings.

**Q: How do I update a container created by a helper script?**
A: Most applications include a companion update script accessible from the same project.

**Q: Do the scripts support Proxmox clusters?**
A: Scripts run on individual nodes. For cluster deployments, run the script on the target node.

## Sources
- https://github.com/community-scripts/ProxmoxVE
- https://community-scripts.github.io/ProxmoxVE/

---
Source: https://tokrepo.com/en/workflows/asset-6c2591f5
Author: AI Open Source