Proxmox-Enhanced-Configuration-Utility (PECU)

Table of Contents

• Overview
• Features
• Requirements
• Compatible Proxmox Versions
• Usage and Installation
• Contribution
• Support
• License

⚠️ Experimental Features Notice
The latest updates, including Intel iGPU detection, rollback functionality for GPU passthrough, and multi-GPU support, are currently in a testing phase. These features may not be fully stable and could require further adjustments. Use with caution, especially in production environments, and report any issues you encounter to help improve the script’s reliability.

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.

Features

The proxmox-configurator.sh script includes the following features:

• Dependency Installation:

  • Backup and Restore: Create and restore backups of the sources.list file, ensuring recovery points for system configurations.
  • Modify sources.list: Edit the sources.list file directly within the script interface using Nano or automatically add recommended repositories.

• GPU Passthrough Configuration:

  • Set up GPU passthrough to assign dedicated graphics cards to virtual machines, improving performance for compute-intensive tasks.
  • Includes rollback functionality to undo passthrough configurations if needed.

• System Configuration Checks:

  • Verifies if the Proxmox package repositories are correctly configured.
  • Displays the state of IOMMU and MSI options to optimize hardware settings.

• Multi-GPU Support:

  • Detects and displays details for NVIDIA, AMD, and Intel GPUs, with tailored options for Data Center or Gaming GPUs.

• Exit Option:

  • Safely exits the script, ensuring a clean shutdown of any ongoing operations.

Requirements

To use this script, the following are required:

• Proxmox VE: This script is designed specifically for use on Proxmox VE systems.
• Root Privileges: Must be run with root or sudo privileges to modify system configurations and perform installations.
• Basic Proxmox Knowledge: Familiarity with Proxmox setup and configuration is recommended for optimal use of the script's features.

Compatible Proxmox Versions

The proxmox-configurator.sh script has been tested and is compatible with the following Proxmox VE versions:

• Proxmox VE 7.x
• Proxmox VE 8.x

Usage and Installation

You can run the script directly from your Proxmox server or clone the repository and execute it locally. Follow the instructions below for each method.

Direct Execution

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/proxmox-configurator.sh)

Note: This command requires an active internet connection and is specific to Linux systems with Bash and Curl installed.

Local Installation

Alternatively, you can clone this repository and run the script from your local Proxmox environment:

1. Clone the Repository:

   git clone https://github.com/Danilop95/Proxmox-Enhanced-Configuration-Utility.git
   cd Proxmox-Enhanced-Configuration-Utility

2. Set Execution Permissions:

   Ensure the script has the necessary execution permissions. If not, grant them with:

   chmod +x proxmox-configurator.sh

3. Run the Script:

   Execute the script with root privileges:

   sudo ./proxmox-configurator.sh

4. Follow the Interactive Menu:

   The script will present an interactive menu. Follow the on-screen instructions to perform the desired operations.

Common Commands

Here are some common commands to use with this script:

chmod +x proxmox-configurator.sh
sudo ./proxmox-configurator.sh

Contribution

We welcome contributions to enhance the functionality and compatibility of this utility script. You can contribute in several ways:

• Issues: Report bugs or suggest new features by opening an issue on our GitHub repository.
• Pull Requests: Submit your improvements through a pull request. Make sure to follow the contribution guidelines in the repository.

Support

If you find this project helpful and would like to support its development, consider buying me a coffee!

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). For more information, please refer to the LICENSE file in the repository.