The Complete Toolkit for
Proxmox GPU Passthrough
From intelligent hardware detection to automated cluster deployment, PECU provides enterprise-grade tools for GPU passthrough configuration on Proxmox VE.
Built for
Enterprise Scale
Comprehensive tooling for every aspect of GPU passthrough configuration, from initial setup to advanced cluster management.
Repository Management
Automatic backup/restore of sources.list with smart no-subscription repo configuration and idempotent operations.
- Auto-detects Proxmox VE version
- Disables enterprise repos
- Safe to re-run anytime
Hardware Detection
Comprehensive system analysis with CPU vendor detection, virtualization support, and IOMMU group mapping.
- Intel VT-x / AMD-V verification
- BIOS type detection (UEFI/Legacy)
- Multi-GPU discovery with VRAM
Kernel Configuration
Advanced kernel parameter management with pcie_acs_override support and bootloader-agnostic configuration.
- GRUB & systemd-boot support
- video=efifb:off for GPUs
- Syntax validation before apply
Bootloader Detection
Automatic detection and configuration for both systemd-boot and GRUB with specific optimizations for each.
- systemd-boot configuration
- GRUB update-grub integration
- Automatic backup before changes
VFIO Configuration
Automatic VFIO module configuration with device IDs, driver blacklisting, and driverctl override management.
- vfio-pci auto-binding
- Driver blacklist management
- Unbind/rebind tools included
Multi-Platform Support
Full support for Proxmox VE 7.x, 8.x, and 9.x with automatic Debian codename mapping and compatibility checks.
- PVE 7.x (Bullseye) - 8.x (Bookworm)
- PVE 9.x (Trixie) enhanced support
- x86-64 architecture (official)
Multi-Vendor
GPU Support
Wizard-style configuration for NVIDIA, AMD, and Intel GPUs with automatic detection, IOMMU group mapping, and complete rollback capability.
NVIDIA Complete
GeForce, Quadro, Tesla, A-series with automatic Code 43 fix
AMD Full Stack
Radeon, Radeon Pro, Instinct with vendor-reset support
Intel Emerging
Arc, UHD, Iris, iGPU (experimental GVT-g/SR-IOV)
Flexible
Release Strategy
Choose from multiple release channels with GitHub API integration, cryptographic verification, and automatic update detection.
Production Ready
Battle-tested releases for production environments with 12 months of support and maintenance.
Testing Phase
Feature-complete releases undergoing community testing before stable promotion.
Early Access
Experimental features for early adopters and testers to provide feedback.
Proof of Concept
Bleeding-edge experiments that may or may not make it to stable releases.
Automated Builds
Daily automated builds from the main branch for continuous integration testing.
Maintenance Mode
Older releases maintained for critical security fixes and compatibility.
YAML-Based
VM Provisioning
Define complete VM configurations in YAML with JSON Schema validation, automatic GPU assignment, and CLI management tools.
UEFI, Q35 chipset, Looking Glass optimizations
CUDA toolkit, ROCm support, multi-core optimized
Plex/Jellyfin transcoding, hardware acceleration
win11-gaming.yaml
Windows 11 Gaming Template
name: "Windows 11 Gaming" vmid: 100 ostype: "win11" bios: "ovmf" machine: "q35" cpu: cores: 8 sockets: 1 type: "host" memory: size: 32768 gpu: passthrough: true vendor: "nvidia" pci_id: "01:00.0"
Enterprise-Grade
Security First
Comprehensive backup system, configuration versioning, audit logging, and complete rollback capability for mission-critical environments.
Automatic Backup
State snapshot before every critical change in /root/pecu-backup/ with timestamps for easy restoration.
Complete Rollback
One-command rollback of GPU passthrough config restoring GRUB/systemd-boot, modules, and blacklists.
Config Versioning
Change tracking in /etc/pecu/ with state persistence in pecu_state.conf for audit trails.
Comprehensive Logging
Full activity log in /var/log/pecu.log with INFO/ERROR/WARNING/SUCCESS levels and rotation.
Smart Permissions
Auto-detection of root/sudo with confirmation prompts for critical operations and permission validation.
Security Policy
Responsible disclosure process for vulnerabilities with patching workflow documented in SECURITY.md.
Privacy-First
Analytics
Optional, transparent telemetry system with explicit opt-in, HMAC signatures, and complete transparency via JSON preview mode.
What We Collect
Instance ID, PECU version, OS/kernel, CPU/RAM/GPU specs, Proxmox version, storage tech (ZFS/Ceph)
What We DON'T Collect
Hostnames, IPs, usernames, file paths, VM names, configs, disk usage, or any personal identifiable data
Telemetry Payload
JSON Preview Mode
{
"instance_id": "a3f2c8e1-...",
"pecu_version": "2.1.0",
"channel": "stable",
"os": "Debian 12",
"kernel": "6.5.11-8-pve",
"arch": "x86_64",
"cpu": {
"vendor": "Intel",
"model": "Xeon E5-2680",
"cores": 28
},
"memory_gb": 128,
"gpus": [
{
"vendor": "NVIDIA",
"model": "RTX 4090",
"vram_gb": 24
}
],
"proxmox_version": "8.1",
"storage_tech": ["ZFS"],
"features_used": {
"gpu_passthrough": 3,
"repo_config": 1
},
"hmac_signature": "..."
}
Power User
Configuration
Deep customization options for expert users including ACS override, vendor-reset, KVM tuning, and manual parameter editing.
ACS Override Patch
Enable pcie_acs_override downstream/multifunction to bypass IOMMU group limitations on consumer motherboards.
Vendor-Reset Support
Automatic installation of vendor-reset DKMS module to fix AMD GPU reset bugs on VM restart without host reboot.
KVM Options Tuning
Configure KVM-specific options: hidden CPU flag for NVIDIA Code 43 bypass, nested virtualization, huge pages, and more.
Manual Parameter Editor
Interactive editor for kernel parameters with live syntax validation, helpful examples, and dry-run preview before application.
Device Unbind/Rebind
Runtime tools to manually unbind/rebind PCI devices from host drivers without system reboot for testing and troubleshooting.
Live Configuration Verification
Post-reboot verification command that validates IOMMU status, VFIO module loading, and device binding in live system state.
Why Choose
PECU?
See how PECU stacks up against manual configuration and alternative tools for Proxmox GPU passthrough.
| Feature | PECU | Manual Config | Competitor Tools |
|---|---|---|---|
| GPU Passthrough Automation | ✓ | ✗ | Partial |
| Multi-GPU Support | ✓ | ✗ | Limited |
| Complete Rollback | ✓ | ✗ | Partial |
| VM Templates (YAML) | ✓ | ✗ | ✗ |
| GDPR-Compliant Telemetry | ✓ | N/A | Tracking |
| Release Channels (6) | ✓ | N/A | 1-2 |
| Cryptographic Verification | ✓ | N/A | Varies |
| Bootloader Auto-Detection | ✓ | ✗ | GRUB Only |
| Community Support | ✓ | Forums | Varies |
| Open Source | ✓ | N/A | Mixed |
Ready to Simplify Your
GPU Passthrough?
Join thousands of Proxmox users who have automated their GPU passthrough configuration with PECU.