{
  "meta": {
    "title": "Proxmox-Befehle für GPU-Passthrough — lspci, VFIO, IOMMU, qm set hostpci | ProxMenux",
    "description": "Referenz für GPU-Passthrough auf Proxmox VE: Geräteidentifikation mit lspci, VFIO-Module, IOMMU-Gruppen (intel_iommu / amd_iommu), GRUB- und initramfs-Updates, qm set hostpci0 sowie die Einrichtung von NVIDIA-, AMD- und Intel-GPUs.",
    "ogTitle": "Proxmox-Befehle für GPU-Passthrough — lspci, VFIO, IOMMU, qm set hostpci",
    "ogDescription": "Referenz zur Prüfung und Einrichtung von GPU-Passthrough auf Proxmox VE: PCI-Geräte, VFIO-Module, IOMMU-Gruppen, Kernel-Startparameter und qm set hostpci.",
    "twitterTitle": "Proxmox-Befehle für GPU-Passthrough | ProxMenux",
    "twitterDescription": "PCI-Geräte prüfen, VFIO und IOMMU konfigurieren und GPUs an VMs unter Proxmox VE durchreichen."
  },
  "header": {
    "title": "GPU-Passthrough",
    "description": "Referenz für GPU-/TPU-Passthrough auf Proxmox: Geräteidentifikation (lspci), Einrichtung der VFIO-Module, IOMMU-Prüfung, initramfs-/GRUB-Updates und Konfiguration je VM (qm set hostpci, machine q35, bios ovmf).",
    "section": "Hilfe und Informationen"
  },
  "intro": {
    "title": "IOMMU muss in BIOS / UEFI aktiviert sein",
    "body": "Aktivieren Sie IOMMU zuerst in der Firmware: Suchen Sie im BIOS/UEFI nach <em>VT-d</em>, <em>AMD-Vi</em> oder <em>IOMMU</em>. Unter Linux ist es bei AMD und bei Intel mit Proxmox-Kerneln ab 6.8 standardmäßig aktiv. Ältere Intel-Kernel benötigen gegebenenfalls <code>intel_iommu=on</code>. Die optionale Einstellung <code>iommu=pt</code> steuert den IOMMU-Passthrough-Modus und erfordert kein pauschales Abschalten des Host-Framebuffers."
  },
  "commandGroups": [
    {
      "title": "Geräteidentifikation",
      "commands": [
        {
          "command": "lspci -nn | grep -i nvidia",
          "description": "Liste NVIDIA PCI-Geräte"
        },
        {
          "command": "lspci -nn | grep -i vga",
          "description": "Liste aller VGA-kompatiblen Geräte"
        },
        {
          "command": "lspci -nn | grep -i amd",
          "description": "Liste der AMD PCI-Geräte"
        },
        {
          "command": "lspci -nnk | grep -A3 VGA",
          "description": "VGA-Geräte mit Kerneltreibern auflisten"
        },
        {
          "command": "lspci -v -s <PCI_ID>",
          "description": "Detaillierte Informationen für ein bestimmtes PCI-Gerät anzeigen"
        }
      ]
    },
    {
      "title": "VFIO Konfiguration",
      "commands": [
        {
          "command": "dmesg | grep -i vfio",
          "description": "VFIO-Modulmeldungen prüfen"
        },
        {
          "command": "cat /etc/modprobe.d/vfio.conf",
          "description": "VFIO-Passthrough-Konfiguration prüfen"
        },
        {
          "command": "ls -la /etc/modprobe.d/",
          "description": "Liste aller Modprobe-Konfigurationsdateien"
        },
        {
          "command": "cat /etc/modules",
          "description": "Beim Start geladene Module anzeigen"
        },
        {
          "command": "lsmod | grep vfio",
          "description": "Überprüfen Sie, ob VFIO-Module geladen sind"
        }
      ]
    },
    {
      "title": "IOMMU Konfiguration",
      "commands": [
        {
          "command": "cat /etc/default/grub",
          "description": "GRUB Optionen für IOMMU überprüfen"
        },
        {
          "command": "update-grub",
          "description": "GRUB-Änderungen anwenden"
        },
        {
          "command": "dmesg | grep -i iommu",
          "description": "IOMMU-Nachrichten im Kernelprotokoll überprüfen"
        },
        {
          "command": "dmesg | grep -e DMAR -e IOMMU",
          "description": "DMAR und IOMMU Nachrichten überprüfen"
        },
        {
          "command": "find /sys/kernel/iommu_groups/ -type l | sort -V",
          "description": "Liste der IOMMU-Gruppen"
        }
      ]
    },
    {
      "title": "Systemaktualisierungen",
      "commands": [
        {
          "command": "update-initramfs -u",
          "description": "Initramfs-Änderungen anwenden (VFIO)"
        },
        {
          "command": "update-initramfs -u -k all",
          "description": "Aktualisieren Sie Initramfs für alle Kernel"
        },
        {
          "command": "cat /proc/cmdline",
          "description": "Aktuelle Kernel-Boot-Parameter anzeigen"
        }
      ]
    },
    {
      "title": "VM Konfiguration",
      "commands": [
        {
          "command": "qm config <vmid> | grep hostpci",
          "description": "PCI-Durchgangskonfiguration für eine VM anzeigen"
        },
        {
          "command": "qm set <vmid> -hostpci0 <PCI_ID>,pcie=1,x-vga=1",
          "description": "GPU-Passthrough zu einer VM hinzufügen"
        },
        {
          "command": "cat /etc/pve/qemu-server/<vmid>.conf",
          "description": "VM-Konfigurationsdatei anzeigen"
        },
        {
          "command": "qm set <vmid> -machine q35",
          "description": "Setzen Sie VM auf den Q35-Chipsatz (empfohlen für den Durchgang)"
        },
        {
          "command": "qm set <vmid> -bios ovmf",
          "description": "VM auf UEFI/OVMF einstellen, empfohlen bei UEFI-fähigem GPU-ROM"
        }
      ]
    }
  ],
  "afterChangesTip": {
    "title": "Nach dem Wechsel von GRUB- oder Modprobe-Konfigurationen",
    "bodyRich": "Auf Hosts mit GRUB übernehmen Sie Startparameter mit <code>update-grub</code>. Aktualisieren Sie Moduländerungen mit <code>update-initramfs -u -k all</code> und starten Sie neu. Andere Bootloader benötigen ihr eigenes Verfahren. Prüfen Sie mit <code>cat /proc/cmdline</code> die Kernelparameter, mit <code>dmesg | grep -i iommu</code> die IOMMU-Initialisierung und mit <code>find /sys/kernel/iommu_groups/ -type l | sort -V</code> die vorhandenen Gruppen."
  },
  "related": {
    "heading": "Verwandte Themen",
    "items": [
      {
        "href": "/docs/hardware/gpu-vm-passthrough",
        "label": "GPU zu VM hinzufügen (Passthrough)",
        "tail": "- interaktiver ProxMenux-Flow."
      },
      {
        "href": "/docs/hardware/igpu-acceleration-lxc",
        "label": "GPU zu LXC hinzufügen",
        "tail": " — Zugriff auf die GPU-Geräte des Hosts mit einem LXC-Container teilen."
      },
      {
        "href": "/docs/help-info",
        "label": "Übersicht über Hilfe und Informationen",
        "tail": "."
      }
    ]
  }
}