docs: clarify Graphic card setting for GPU passthrough VMs

VMs with a passed-through GPU need Graphic card set to 'none' —
VirtIO-GPU conflicts with the real card. VMs without GPU keep
default VirtIO for console access. Add this to VM 100 and VM 101
System tab tables with explanatory notes.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Claude
2026-06-27 05:41:51 +00:00
parent 2461cfd672
commit 08a0c17cd0
+12
View File
@@ -2132,6 +2132,7 @@ Click **Next**.
| Field | Value | | Field | Value |
|-------|-------| |-------|-------|
| Graphic card | **Default** (VirtIO) |
| Machine | q35 | | Machine | q35 |
| BIOS | OVMF (UEFI) | | BIOS | OVMF (UEFI) |
| Add EFI Disk | checked | | Add EFI Disk | checked |
@@ -2146,6 +2147,9 @@ Click **Next**.
> **Pre-Enrolled Keys must be unchecked.** Enabling it turns on Secure Boot, > **Pre-Enrolled Keys must be unchecked.** Enabling it turns on Secure Boot,
> which blocks NVIDIA kernel modules from loading in the guest. > which blocks NVIDIA kernel modules from loading in the guest.
> **Graphic card stays as Default (VirtIO) for VM 100** — Frigate has no
> passed-through GPU, so it needs the virtual display for console access.
Click **Next**. Click **Next**.
**Tab: Disks** **Tab: Disks**
@@ -2359,10 +2363,18 @@ Click **Create VM** in the web UI.
|-----|-------| |-----|-------|
| General | VM ID: **101**, Name: **vm101** | | General | VM ID: **101**, Name: **vm101** |
| OS | ubuntu-24.04.4-desktop-amd64.iso | | OS | ubuntu-24.04.4-desktop-amd64.iso |
| System → Graphic card | **none** |
| System → Machine | q35 |
| System → BIOS | OVMF (UEFI) |
| System → Pre-Enrolled Keys | **unchecked** |
| CPU | 8 cores, host | | CPU | 8 cores, host |
| Memory | 16384 MiB | | Memory | 16384 MiB |
| Disk | 64 GiB on local-lvm | | Disk | 64 GiB on local-lvm |
> **Graphic card must be set to "none"** when passing through a real GPU.
> Leaving it as VirtIO-GPU creates a conflicting virtual display adapter that
> interferes with the passed-through card.
After the wizard completes, add the GPU in the **Hardware** tab: After the wizard completes, add the GPU in the **Hardware** tab:
Click **Add** → **PCI Device**. Click **Add** → **PCI Device**.