- Overview
- Requirements & Compatibility
- Quick Start
- What Is the Release Selector?
- VM Templates System
- Features
- Community & Contribution
- Support the Project
- License
PECU is a single-shell utility that makes day-to-day Proxmox VE management as painless as possible:
- one-line installer
- interactive menus for repositories, kernel flags, GPU passthrough, etc.
- reversible operations (backup / rollback built-in)
- auto-detects NVIDIA, AMD and Intel iGPUs out of the box
- NEW: declarative VM template system with CLI management tools
- NEW: full Proxmox VE 9.x series support with enhanced compatibility and performance optimizations
The selector and the underlying scripts are designed for a typical, up-to-date Proxmox host. If your stack falls outside the matrix below, use at your own risk.
| Platform |  (fully supports latest Proxmox VE 9.x with enhanced compatibility) |
| CPU arch |  |
| Privileges |  |
Heads-up PECU does not support ARM / Raspberry Pi builds of Proxmox at this time. Community ports are welcome, but official testing is x86-64 only.
New in 2025-05 – a tiny selector script fetches all tagged releases and
lets you launch whichever version (Stable, Beta, Experimental…) you want.
bash <(curl -sL \https://raw.githubusercontent.com/Danilop95/Proxmox-Enhanced-Configuration-Utility/refs/heads/main/scripts/pecu_release_selector.sh)
All releases ship a .tar.gz bundle:
VERSION="v2025.04.14" # pick any tag
wget https://github.com/Danilop95/Proxmox-Enhanced-Configuration-Utility/releases/download/$VERSION/PECU-${VERSION#v}.tar.gz
tar -xzf PECU-${VERSION#v}.tar.gz
cd PECU-${VERSION#v}/src
chmod +x proxmox-configurator.sh
sudo ./proxmox-configurator.shpecu_release_selector.shis a new ASCII-driven menu I built over the last few months. It talks directly to the GitHub API, parses every tag, and sorts them by the customPECU-Channellabels I introduced (Stable, Beta, Preview, Experimental, Nightly). The channels keep the list tidy and make it obvious which way the project is heading.- Marking a build as Experimental instantly flags it orange in the menu, so I can ship rough prototypes or quick-fix versions without confusing people who only want Stable releases. lector.
pecu_release_selector_old.shstill exists only as a shim thatexecs the new script — it will be removed on 05 July 2025.
New in 2025.08 – PECU now includes a declarative VM template system with CLI management tools.
- Declarative YAML templates for common VM configurations (Windows Gaming, Linux Workstation, Media Server)
- JSON Schema validation ensuring template consistency and correctness
- CLI management with
templatectl.shfor listing, validating, rendering, and applying templates - Safe rendering – view
qmcommands before execution with--dry-run - Storage flexibility – supports
local-lvm,local, and auto-detection - CI/CD ready – GitHub Actions workflow for automatic validation
# List available templates
src/tools/templatectl.sh list --channel Stable
# Validate all templates
src/tools/templatectl.sh validate templates/
# Preview commands (safe, no execution)
src/tools/templatectl.sh render templates/windows/windows-gaming.yaml \
--vmid 200 --storage-pool local-lvm --dry-run
# Apply template (creates VM)
sudo src/tools/templatectl.sh apply templates/windows/windows-gaming.yaml \
--vmid 200 --storage-pool local-lvm| Template | Channel | OS Type | Description |
|---|---|---|---|
windows-gaming |
Stable | win11 | Windows 11 VM optimized for gaming with GPU passthrough support |
linux-workstation |
Stable | l26 | Linux workstation for development and productivity |
media-server |
Stable | l26 | Lightweight Linux VM for media services (Plex, Jellyfin, etc.) |
See templates/README.md for detailed documentation.
| Category | Highlights |
|---|---|
| Repositories | Backup / restore sources.list, add "non-subscription" repo, edit with Nano. |
| GPU Passthrough | Wizard-style setup for NVIDIA, AMD, Intel; supports driverctl override; rollback option. |
| Kernel Tweaks | Add pcie_acs_override, video=efifb:off, or custom flags with risk prompts. |
| Multi-GPU | Detects multiple GPUs and lets you choose the one to passthrough. |
| Intel iGPU (test) | Experimental automatic isolation of iGPU functions. |
| VM Templates | Declarative YAML templates with CLI tools for common VM configurations. |
| Template Validation | JSON Schema validation and CI/CD integration for template quality assurance. |
| Proxmox 9.x | Full support for the latest Proxmox VE 9.x series with enhanced compatibility and performance optimizations. |
| Logging | Detailed /var/log/pecu.log with timestamps and automatic log rotation. |
PECU grows through clear bug reports, well-scoped ideas, and peer-reviewed code.
If you would like to get involved, choose the channel that best suits your needs:
| Purpose | Channel |
|---|---|
| Bug reports / feature requests | Use the GitHub Issue tracker. Please include the tag you were running, a concise description, and any relevant console output. |
| Code contributions | Fork the repository, branch from main, run shellcheck, keep commits focused, then open a Pull Request. |
| Technical discussion and quick feedback | Join the PECU Discord server: https://discord.gg/euQTVNc2xg. The server is used for informal Q&A, brainstorming future features, and sharing configuration tips. |
| Sustained support and early-access builds | Patreon memberships are available at https://www.patreon.com/c/DVNILXP95. Patrons receive preview builds, detailed implementation notes, and can vote on the development roadmap. |
If PECU saves you time in daily operations and you wish to accelerate its development, consider a one-off donation:
Your support funds additional test hardware.
GPL-3.0 – see LICENSE. Feel free to fork, adapt, and share under the same terms.
