Skip to main content
Proxmox VE Helper Scripts Logo

​
Welcome to Proxmox VE Helper Scripts

A Community Legacy in Memory of @tteck Proxmox VE Helper Scripts simplify your Proxmox VE setup with community-driven automation scripts. Originally created by tteck, the project is now maintained and expanded by the community to help you quickly deploy containers, virtual machines, and tools with simple bash commands.

Quick Start

Get up and running in minutes with your first script installation

Installation Methods

Choose from web installer, bash commands, or PVEScripts-Local UI

Browse Scripts

Explore 200+ ready-to-use scripts for popular applications

Community

Join our Discord for support and discussions

​
Why Proxmox VE Helper Scripts?

Quick Setup

One-command installations for popular services and containers. No manual configuration needed.

Flexible Configuration

Simple mode for beginners, advanced options for power users. You’re always in control.

Auto Updates

Keep your installations current with built-in update mechanisms via the update command.

Community Driven

Actively maintained with contributions from users worldwide. Built by the community, for the community.

​
What Can You Install?

Proxmox VE Helper Scripts provides automation for:
1

Containers (LXC)

Over 200 scripts for deploying lightweight Linux containers running popular applications:
  • Home Automation: Home Assistant, ESPHome, Node-RED
  • Media: Plex, Jellyfin, Emby, Radarr, Sonarr
  • Networking: AdGuard, Pi-hole, Nginx Proxy Manager, WireGuard
  • Development: Docker, Portainer, GitLab, Gitea
  • Monitoring: Uptime Kuma, Grafana, Prometheus
  • And many more…
2

Virtual Machines

Automated VM creation for full operating systems:
  • Home Assistant OS
  • Ubuntu (22.04, 24.04, 25.04)
  • Debian
  • TrueNAS
  • OpenWRT, OPNsense
  • And others…
3

Proxmox Tools

Essential utilities for managing your Proxmox host:
  • Post-installation setup (post-pve-install.sh)
  • Kernel management and cleaning
  • LXC batch updates and monitoring
  • Hardware acceleration setup
  • USB passthrough configuration

​
System Requirements

Proxmox VE

Version 8.4.x | 9.0.x | 9.1.xDebian-based with Proxmox tools installed

Network

Internet connection requiredScripts download packages and images from the web

Access

Shell access to ProxmoxRun commands via the web UI shell or SSH
Most scripts create unprivileged containers by default for better security. Privileged containers are only used when necessary (e.g., Docker with USB passthrough).

​
How It Works

Proxmox VE Helper Scripts use a two-script architecture:
1

Container Script (ct/*.sh)

You run this script from your Proxmox host shell. It:
  • Sources the build.func framework for container creation
  • Prompts for configuration (or uses defaults in simple mode)
  • Creates the LXC container with specified resources
  • Calls the install script inside the container
2

Install Script (install/*-install.sh)

This script runs inside the newly created container. It:
  • Updates the OS packages
  • Installs application dependencies
  • Downloads and configures the application
  • Sets up systemd services for auto-start
  • Reports success and provides access URL
# Example: Installing Docker
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/ct/docker.sh)"

# What happens:
# 1. ct/docker.sh creates the LXC container
# 2. install/docker-install.sh runs inside and installs Docker
# 3. You get a running Docker container in ~2 minutes

​
Real-World Example

Let’s say you want to run AdGuard Home for network-wide ad blocking: 
# 1. Create LXC container manually in Proxmox UI
# 2. Configure CPU, RAM, disk, network
# 3. Start container and open shell
# 4. Update package lists
# 5. Install dependencies
# 6. Download AdGuard binary
# 7. Extract and move to /opt
# 8. Create systemd service file
# 9. Enable and start service
# 10. Configure firewall
# ... 20+ manual steps, 30+ minutes

​
Community & Support

This project is maintained by the community in memory of tteck, the original creator.

Discord

Real-time chat, support, and discussions

GitHub Discussions

Feature requests, Q&A, and ideas

GitHub Issues

Bug reports and issue tracking
Support the Project: 30% of all donations go directly to cancer research and hospice care in memory of tteck. Donate on Ko-fi

​
What’s Next?

Run Your First Script

Follow our quickstart guide to install your first application

Explore Installation Methods

Learn about all the ways to use these scripts
Always review scripts before running them on your system. While community-maintained and audited, you should understand what each script does. Visit helper-scripts.com to browse script details.

Build docs developers (and LLMs) love

Get started for freeTalk to us