Skip to content

GPU Passthrough#



Host Installation/Configuration#

VergeOS includes the driver for generic PCI address passthrough; typically, no additional host drivers are needed for GPU passthrough. {.is-info}

  1. From the Main Dashboard, click Nodes.
  2. Click Drivers on the left menu.
  3. Click New on the left menu.

ledunsupported.png

  1. Select node from the dropdown list.
  2. Select VFIO-PCI Passthrough in the Driver dropdown list.
  3. Check/select all display controller PCI devices to be used for GPU passthrough, in the Apply to PCI Devices section.
  4. Click Submit at the bottom of the page.



Guest Configuration#

  1. Power down the VM.
  2. Navigate to the dashboard of the desired VM (From the main dashboard click Machines on the left menu, Virtual Machines, double-click desired VM in the listing.)
  3. Click Devices on the left menu.
  4. Click New on the left menu. The Device Entry Form appears.

ledunsupported.png

  1. Optionally, a Name and Description can be entered for the device.
  2. Select GPU Passthrough in the Type dropdown list.
  3. UUID is a universally unique identifier and is persistent across reboots. Typically UUID should be left blank to allow the system to automatically assign one to the device; a specific UUID can be entered if necessary (e.g. imported or cloned VMs with existing GPU PCI device).
  4. Click Submit at the bottom of the page.
  5. Power on the VM.
  6. Install appropriate guest driver. Required guest driver(s) will depend on specific GPU hardware and guest OS version. Consult your GPU hardware documentation for guidance.


Get vergeOS license keys