proxmox-pci-passthrough

Configure Proxmox VE PCI passthrough for GPUs and USB devices.

Updated Oct 23, 2024
One-click install
npx skills add https://github.com/lenadlm/docker --skill proxmox-pci-passthrough
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proxmox-pci-passthrough
Source: https://github.com/lenadlm/docker/tree/main/hermes-skills/skills/netops/proxmox-pci-passthrough
Command: npx skills add https://github.com/lenadlm/docker --skill proxmox-pci-passthrough

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill unit streamlines the process of pass-through PCI devices to VMs on Proxmox VE, overcoming hardware and software constraints for improved performance and functionality.

Core Features & Use Cases

  • IOMMU and VFIO Setup: Configure the host and VM for IOMMU passthrough mode with VFIO support.
  • Driver Binding: Pre-bind PCI devices to VFIO during system initialization.
  • VM Configuration: Specify the passthrough PCI device in VM configurations for GPU, USB, or NVMe use.
  • Wayland Scaling for 4K TV: Provide optimal UI scaling for 4K TV displays on GNOME Wayland.
  • Caveats and Troubleshooting: Include best practices and mitigations for common issues in GPU and iGPU passthrough, display detection, and root configurations.
  • Verification: Offers a detailed verification checklist post-installation for PCI device detection and binding, and VM display verification.
  • References: Links to specific hardware setup details for iGPU passthrough on the HP ProDesk 600 G5 Mini.
  • VM Requirements: Detailed setup steps and considerations for GPU and VM configurations including required firmware and driver setups.

Quick Start

Enable PCI passthrough for a GPU with Intel iGPU using qm set <VMID> -hostpci0 <PCI_ADDR>,pcie=1,x-vga=1

Frequently Asked Questions about proxmox-pci-passthrough

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up PCI passthrough for a GPU in Proxmox VE?

GPU passthrough in Proxmox VE requires configuring the host for IOMMU, binding the PCI device to VFIO drivers, and attaching the device to the VM using the qm set command with hostpci parameters. This Skill provides the scripts and steps for the complete setup.

What is VFIO driver binding and when do I need it for Proxmox virtualization?

VFIO driver binding secures physical PCI devices for exclusive VM use by preventing the host OS from loading default drivers. You need it when configuring IOMMU passthrough mode for devices like GPUs or NVMe drives in Proxmox.

Can I use Intel iGPU passthrough with Proxmox on specific hardware like the HP ProDesk 600 G5 Mini?

Yes, Proxmox iGPU passthrough works on supported hardware like the HP ProDesk 600 G5 Mini. This Skill includes specific references and configuration caveats for display detection and driver setup on Intel integrated graphics.

Why does my passthrough VM display have UI scaling issues on a 4K TV?

4K TV display scaling issues occur because default VM display configurations lack optimal UI scaling for high resolutions. This Skill provides specific Wayland scaling configurations for GNOME to correct the interface size on 4K displays.

How do I verify if PCI passthrough is working correctly in Proxmox?

Verify PCI passthrough by checking the detailed post-installation checklist for proper PCI device detection, confirming VFIO driver binding on the host, and validating the VM display output for the passthrough GPU.