¶ Getting SR-IOV to work in UNRAID
Good resources:
- https://github.com/strongtz/i915-sriov-dkms
- https://www.jackiewu.top/article/unraid-intel-igd-sr-iov#f5c53c233ebc4ae4ba0081fa4048b459
¶ 1 - BIOS
- Turn on SR-IOV support in BIOS. Supported GPUs:
https://www.intel.com/content/www/us/en/support/articles/000093216/graphics/processor-graphics.html - Also turn on Virtualisation (VT-D, VT-X, HVM, Intel Virtualization etc), and IOMMMU support
¶ 2 - UNRAID Plugin
Install the "Intel iGPU SR-IOV" UNRAID plugin by giganode
¶ 3 - UNRAID Setup
- In UNRAID, go to
settings->"Intel Graphics SR-IOV"and set VF numbers to >1. - Save to config
- For Ultra 265k, go to
Main -> Flash -> Syslinux Configurationand add force_probe etc:
Unraid OS
kernel /bzimage
append initrd=/bzroot i915.force_probe=7d67 intel_iommu=on iommu=pt i915.enable_guc=3 i915.max_vfs=7 module_blacklist=xe
Unraid OS GUI Mode
kernel /bzimage
append initrd=/bzroot,/bzroot-gui i915.force_probe=7d67 intel_iommu=on iommu=pt i915.enable_guc=3 i915.max_vfs=7 module_blacklist=xe
- Reboot
¶ 3.1 Add a Virtual Machine and configure KVM
- Set the graphics card in the VM to one of the virtual devices (NOT 2.0, that is reserved for host!).
- Edit XML of VM and change:
<hyperv mode='passthrough'>
</hyperv>
<kvm>
<hidden state='on'/>
</kvm>
<cpu mode='host-passthrough' check='none' migratable='on'>
<topology sockets='1' dies='1' clusters='1' cores='20' threads='1'/>
<cache mode='passthrough'/>
<feature policy='disable' name='la57'/>
<maxphysaddr mode='passthrough' limit='40'/>
</cpu>
¶ Linux
<clock offset='utc'>
<timer name='hpet' present='yes'/>
<timer name='hypervclock' present='no'/>
<timer name='pit' tickpolicy='delay'/>
<timer name='rtc' tickpolicy='catchup'/>
</clock>
¶ Windows
<clock offset='localtime'>
<timer name='hpet' present='no'/>
<timer name='hypervclock' present='yes'/>
</clock>
¶ 4 - VM Setup (Ubuntu 24.04.3)
This is the order I did it in, combining multiple articles...
- Fire up the Ubuntu VM
- Install client packages:
apt install build-* dkms linux-headers-$(uname -r) linux-modules-extra-$(uname -r)
wget -O /tmp/i915-sriov-dkms_2025.10.10_amd64.deb "https://github.com/strongtz/i915-sriov-dkms/releases/download/2025.10.10/i915-sriov-dkms_2025.10.10_amd64.deb"
dpkg -i /tmp/i915-sriov-dkms_2025.10.10_amd64.deb
- Getting Grub to behave:
- For 14700k: Update kernel parameters nano /etc/default/grub and change GRUB_CMDLINE_LINUX_DEFAULT to, or add to it if you have other arguments there already.
i915.enable_guc=3 module_blacklist=xe
- For 265K: update /etc/default/grub with
GRUB_CMDLINE_LINUX_DEFAULT="quiet splash i915.force_probe='7d67' i915.enable_guc=3 module_blacklist=xe"
- Once that's done, update grub and initramfs, then reboot.
update-grub
update-initramfs -u
- Install hwe kernel if not already installed:
sudo apt install -y --install-suggests linux-generic-hwe-24.04
sudo reboot
- Install intel drivers:
sudo apt install intel-opencl-icd
- Verify functionality:
j@dev:~$ lspci -k | grep -EA3 'VGA|3D|Display'
06:00.0 VGA compatible controller: Intel Corporation Raptor Lake-S GT1 [UHD Graphics 770] (rev 04)
Subsystem: Micro-Star International Co., Ltd. [MSI] Raptor Lake-S GT1 [UHD Graphics 770]
Kernel driver in use: i915
Kernel modules: i915, xe
j@dev:~$ sudo lshw -C display
*-display
description: VGA compatible controller
product: Raptor Lake-S GT1 [UHD Graphics 770]
vendor: Intel Corporation
physical id: 0
bus info: pci@0000:06:00.0
version: 04
width: 64 bits
clock: 33MHz
capabilities: pciexpress msi vga_controller bus_master cap_list
configuration: driver=i915 latency=0
resources: iomemory:38280-3827f irq:41 memory:80000000-80ffffff memory:382800000000-38281fffffff
j@dev:~$ ls -la /dev/dri
total 0
drwxr-xr-x 3 root root 100 Oct 25 09:27 .
drwxr-xr-x 20 root root 4060 Oct 25 09:42 ..
drwxr-xr-x 2 root root 80 Oct 25 09:27 by-path
crw-rw---- 1 root video 226, 0 Oct 25 09:27 card0
crw-rw---- 1 root render 226, 128 Oct 25 09:27 renderD128
sudo apt install vainfo
vainfo
¶ Sunshine
Don't trust these - lots of iteration, need to reestablish clean baseline!
- Download sunshine-ubuntu-24.04-amd64.deb from Latest Releases
sudo dpkg -i ./sunshine-ubuntu-24.04-amd64.deb
- sudo setcap cap_sys_admin+p $(readlink -f $(which sunshine))
- add current user to render and video groups, and restart
- systemctl --user start sunshine
- systemctl --user enable sunshine
- go to webpage: https://localhost:47990/
If using xrdp too, you need to set up sunshine on :11 (xrdp will be :10) - took forever with claude to get it right! Mouse and keyboard use x11 not uinput! Need a virtual (dummy) display.
Also need to start new d-bus session for desktop to work.
# Start a new D-Bus session for this display to avoid conflicts with :10
eval $(dbus-launch --sh-syntax)
export DBUS_SESSION_BUS_ADDRESS
¶ Windows VM
Edit the VM XML in UNRAID and make sure these two under features are this:
<hyperv mode='passthrough'>
</hyperv>
<kvm>
<hidden state='on'/>
</kvm>
I also added the firmware, following the instructions at the official page
My BIOS showed TWO string matches, I have used the first.
I also clean-installed the intel drivers, I'm not sure if that was necessary.
¶ Issues
The following is fixed with the maxphysaddr line above:
2025-10-30T20:35:03.572284Z qemu-system-x86_64: VFIO_MAP_DMA failed: Invalid argument
2025-10-30T20:35:03.572328Z qemu-system-x86_64: vfio_container_dma_map(0x55d7caffdf80, 0x382800000000, 0x1000000, 0x14c632000000) = -2 (No such file or directory)
2025-10-30T20:35:03.587844Z qemu-system-x86_64: VFIO_MAP_DMA failed: Invalid argument
2025-10-30T20:35:03.587858Z qemu-system-x86_64: vfio_container_dma_map(0x55d7caffdf80, 0x382800000000, 0x1000000, 0x14c632000000) = -22 (Invalid argument)
2025-10-30T20:35:03.623796Z qemu-system-x86_64: VFIO_MAP_DMA failed: Invalid argument
2025-10-30T20:35:03.623810Z qemu-system-x86_64: vfio_container_dma_map(0x55d7caffdf80, 0x382800000000, 0x1000000, 0x14c632000000) = -22 (Invalid argument)
¶ Things not to do
- DO NOT DO THIS (not needed and causes VMs not to start on reboot UNRAID):
Go toTools -> System Devicesand select the00:02.1, ...lines for the UHD graphics (VGA compatible controller), then selectBind selected to VFIO at boot.
- And add maxphysaddr line:
<maxphysaddr mode="passthrough" limit="39"/>
- 39 should be 40.