Installation Guide

This comprehensive guide will walk you through installing PECU on your Proxmox VE system. Follow each step carefully to ensure a successful installation.

Pre-Installation Steps

1. System Backup

Create a complete backup of your Proxmox VE configuration before proceeding:

# Backup Proxmox VE configuration
tar -czf proxmox-backup-$(date +%Y%m%d).tar.gz /etc/pve/

# Backup important system files
cp /etc/default/grub /etc/default/grub.backup
cp /etc/modules /etc/modules.backup

2. Update System

Ensure your Proxmox VE system is fully updated:

# Update package lists and system
apt update && apt full-upgrade -y

# Reboot if kernel was updated
reboot

Installation Methods

Method 1: Automated Installation (Recommended)

The easiest way to install PECU is using our automated installer:

# Download and run the installer
curl -fsSL https://get.pecu.sh | bash

The installer will:

• ✅ Check system compatibility
• ✅ Download required packages
• ✅ Configure system settings
• ✅ Set up GPU passthrough (if applicable)
• ✅ Optimize performance settings

Method 2: Manual Installation

For advanced users who prefer manual control:

Step 1: Download PECU

# Create installation directory
mkdir -p /opt/pecu
cd /opt/pecu

# Download latest release
wget https://github.com/pecu-project/pecu/releases/latest/download/pecu-linux-amd64.tar.gz

# Extract archive
tar -xzf pecu-linux-amd64.tar.gz

Step 2: Install Dependencies

# Install required packages
apt install -y \
    pve-headers \
    build-essential \
    dkms \
    git \
    curl \
    wget \
    unzip

# Install VFIO modules (for GPU passthrough)
echo "vfio" >> /etc/modules
echo "vfio_iommu_type1" >> /etc/modules
echo "vfio_pci" >> /etc/modules
echo "vfio_virqfd" >> /etc/modules

Post-Installation Configuration

After successful installation, verify everything is working properly and proceed with initial configuration steps.