Overview
The Proxmox-Enhanced-Configuration-Utility (PECU) is a powerful Bash script designed to streamline the configuration and management of Proxmox VE environments. This utility provides an interactive menu system for performing key tasks, such as managing package repositories and configuring GPU passthrough, simplifying Proxmox setup and optimization for diverse use cases.
Script Demos
PECU Release Selector
The Release Selector allows you to choose which version of PECU to run, including stable releases and pre-releases.
GPU Passthrough Configuration
PECU simplifies the complex process of setting up GPU passthrough for virtual machines, with support for NVIDIA, AMD, and Intel GPUs.
Features
Dependency Installation
Backup and restore sources.list file, and edit repositories directly within the script interface.
GPU Passthrough Configuration
Set up GPU passthrough to assign dedicated graphics cards to virtual machines, with rollback functionality.
System Configuration Checks
Verifies if the Proxmox package repositories are correctly configured and displays IOMMU and MSI options.
Multi-GPU Support
Detects and displays details for NVIDIA, AMD, and Intel GPUs, with tailored options for different GPU types.
Proxmox Compatibility
Compatible with Proxmox VE 7.x and 8.x versions, ensuring broad support across environments.
Rollback Functionality
Safely undo configurations with built-in rollback capabilities to restore previous system states.
Installation
Choose your installation method
You can run the script directly from your Proxmox server or clone the repository
To run the script directly from the internet, use the following command:
bash <(curl -sL https://raw.githubusercontent.com/Danilop95/Proxmox-Enhanced-Configuration-Utility/refs/heads/main/scripts/pecu_release_selector.sh)
Note: This command requires an active internet connection and is specific to Linux systems with Bash and Curl installed.
Clone the Repository:
git clone https://github.com/Danilop95/Proxmox-Enhanced-Configuration-Utility.git
cd Proxmox-Enhanced-Configuration-Utility
Set Execution Permissions:
chmod +x proxmox-configurator.sh
Run the Script:
sudo ./proxmox-configurator.sh
Releases
v2025.04.14
Released 2 days ago
What's New in This Update:
This update brings several improvements and bug fixes to enhance the performance and reliability of the Proxmox Enhanced Configuration Utility (PECU). Key changes include:
- Performance Optimizations: Overall improvements for faster execution and smoother operation.
- Enhanced Error Handling: Better diagnostics with detailed log messages to help troubleshoot issues.
- Driverctl Passthrough Method: New support for GPU passthrough using driverctl, providing an alternative to the classic configuration approach.
- Advanced Kernel Tweaks: New submenu to easily append kernel parameters for customized system performance and compatibility.
- User Interface Enhancements: Updated CLI appearance with a loading banner, spinner, and clear prompts.
How to Update
You can update your PECU installation using the source code provided in this release. There are two ways to run this version:
Direct Execution (Latest Version):
bash <(curl -sL https://raw.githubusercontent.com/Danilop95/Proxmox-Enhanced-Configuration-Utility/v2025.04.14/proxmox-configurator.sh)
Local Installation:
wget https://github.com/Danilop95/Proxmox-Enhanced-Configuration-Utility/releases/download/v2025.04.14/PECU-2025.04.14.tar.gz && \
tar -xzvf PECU-2025.04.14.tar.gz && \
cd PECU-2025.04.14 && \
chmod +x proxmox-configurator.sh && \
sudo ./proxmox-configurator.sh
Important Note
This release is a test release — it's the first time we're implementing automated releases. We apologize for any inconvenience caused by this initial notification. We are working to improve the release process for future versions.
v2025.03.03
Released March 3, 2025
What's New in This Update
This update brings several improvements and bug fixes to enhance the performance and reliability of the Proxmox Enhanced Configuration Utility (PECU). Detailed changes include performance optimizations and improved error handling for a smoother experience.
How to Update
You can update your PECU installation using the source code provided in this release. There are two ways to run this version:
Direct Execution (Latest Version):
bash <(curl -sL https://raw.githubusercontent.com/Danilop95/Proxmox-Enhanced-Configuration-Utility/v2025.03.03/proxmox-configurator.sh)
Local Installation:
wget https://github.com/Danilop95/Proxmox-Enhanced-Configuration-Utility/releases/download/v2025.03.03/PECU-2025.03.03.tar.gz && \
tar -xzvf PECU-2025.03.03.tar.gz && \
cd PECU-2025.03.03 && \
chmod +x proxmox-configurator.sh && \
sudo ./proxmox-configurator.sh
GitHub Integration
Latest Release
Information about the most recent version
v2025.04.14
Pre-releaseLatest release of Proxmox-Enhanced-Configuration-Utility with improved GPU detection and rollback functionality