NVIDIA-Treiber unter Debian 12 und 13 installieren: APT, CUDA und Secure Boot

Ein NVIDIA-Treiber unter Debian ist mehr als eine heruntergeladene Datei. Paketquellen, Kernel-Header, DKMS und eventuell Secure Boot müssen zusammenpassen. Wer Anleitungen für verschiedene Distributionen mischt, verliert dabei schnell den Überblick.

Mein NVIDIA-Installationsskript für Debian 12 und 13 führt durch einen APT-basierten Ablauf. Der normale Installationsweg nutzt Debians eigene Pakete. Du entscheidest im Menü zwischen Stable, bereits eingerichteten Backports und den Optionen zum Entfernen des Treibers. Das CUDA Toolkit ist eine separate Auswahl.

Was bringt der APT-basierte Weg?

Treiber und Abhängigkeiten bleiben im Paketmanagement sichtbar. Das macht spätere Aktualisierungen und die Suche nach Installationsproblemen nachvollziehbarer. Das Skript legt im normalen APT-Weg kein zusätzliches NVIDIA-Repository an und erzwingt keinen Wechsel von Wayland zu Xorg.

• Vorbedingungen prüfen: Debian-Version, Architektur, NVIDIA-Grafikgerät und Paketquellen werden vor der Menüaktion überprüft.
• Passende Bauteile vorbereiten: Das Skript installiert unter anderem DKMS und verfügbare Kernel-Header.
• Entscheidungen sichtbar machen: Stable, Backports und CUDA werden ausdrücklich ausgewählt.
• Fehler nachlesen: Die Ausgabe wird zusätzlich unter /var/log/nvidia-optimizer.log protokolliert.

Trotz des Log-Dateinamens ist das keine automatische FPS-Optimierung. Der Nutzen liegt im geführten Installationsablauf. Leistung und Kompatibilität hängen weiterhin von GPU, Treiberversion, Anwendung und System ab.

Für welche Systeme ist das Skript gedacht?

Unterstützt werden Debian 12 Bookworm und Debian 13 Trixie mit amd64 oder arm64. Das Skript erwartet ein erkanntes NVIDIA-PCI-Grafikgerät und Root-Rechte. Es ist keine allgemeine Anleitung für Ubuntu, Arch Linux oder andere Distributionen.

Die Architekturprüfung allein garantiert nicht, dass Debians ausgewählter Treiber jede Grafikkarte unterstützt. Prüfe vor der Installation, ob dein GPU-Modell zu diesem Treiberzweig passt. Gerade ältere Karten können einen anderen Zweig benötigen.

Die eingerichteten Debian-Quellen müssen die benötigten Bereiche main, contrib, non-free und non-free-firmware bereitstellen. Das Skript prüft klassische .list-Dateien und das deb822-Format .sources. Fehlen Bereiche, zeigt es Hinweise; es schreibt deine Quellen nicht automatisch um.

Skript laden und bewusst starten

Lies zunächst die Anleitung und die Skriptdatei im Repository. Das Werkzeug installiert und entfernt Systempakete und aktualisiert die initramfs. Sichere wichtige Daten und plane einen Neustart ein. Falls früher ein NVIDIA-.run-Installer verwendet wurde, kläre diese bestehende Installation zuerst.

Wenn Git installiert ist, lade das Projekt:

git clone https://github.com/dennishilk/nvidia-driver.git

Wechsle in den Projektordner:

cd nvidia-driver

Nach dem Lesen des Skripts startest du es mit Root-Rechten:

sudo bash ./install-nvidia-cuda.sh

Bei laufenden APT- oder dpkg-Prozessen wartet das Skript begrenzt und bricht gegebenenfalls ab. Es beendet keine Paketmanager und löscht keine Sperrdateien. Lass eine bereits laufende Paketinstallation fertig werden, bevor du erneut startest.

Stable, Backports oder CUDA: Was wähle ich?

Für einen gewöhnlichen Desktop brauchst du nicht automatisch das vollständige CUDA Toolkit. Manche Anwendungen bringen passende Laufzeitbibliotheken mit; entscheidend ist deren Dokumentation. Das optionale Debian-Paket ist keine Zusage, dass eine bestimmte Anwendung jede CUDA-Version akzeptiert.

Das Menü enthält außerdem einen fortgeschrittenen .run-Weg für amd64. Er verlässt den normalen Debian-Paketweg und kann mit APT-Installationen kollidieren. Für den hier beschriebenen Ablauf bleibst du bei den APT-Optionen.

Kernel-Header, DKMS und Secure Boot verstehen

DKMS baut das benötigte Kernel-Modul. Dafür müssen die Header zum Kernel passen. Das Skript versucht sowohl das Header-Metapaket der Architektur als auch die Header des laufenden Kernels zu installieren, sofern diese verfügbar sind.

Ist nur der Header-Satz eines neueren Debian-Kernels verfügbar, kann zunächst ein Neustart in diesen Kernel nötig sein. Dein aktuell laufender Kernel lässt sich so anzeigen:

uname -r

Den Zustand der DKMS-Builds zeigt:

dkms status

Mit aktiviertem Secure Boot kann ein nicht vertrautes Kernel-Modul trotz installierter Pakete am Laden gehindert werden. Das Skript gibt Hinweise zur MOK-Einschreibung, führt sie aber nicht automatisch aus. Prüfe die DKMS-Anleitung für dein System und ob das erwartete Zertifikat existiert. Bei vorhandenem mokutil zeigt dieser Befehl den Secure-Boot-Status:

mokutil --sb-state

Eine notwendige Einschreibung verlangt anschließend einen bewussten Schritt im MOK Manager beim Neustart. Der Abschluss der Paketinstallation allein bestätigt diesen Schritt nicht.

Installation nach dem Neustart prüfen

Starte nach der Installation neu und prüfe den Treiber:

nvidia-smi

Wenn du das CUDA Toolkit installiert hast, kannst du zusätzlich den Compiler prüfen:

nvcc --version

Fehlt nvcc, obwohl der Treiber funktioniert, ist das nicht automatisch ein Treiberfehler. Treiber und Toolkit sind unterschiedliche Komponenten. Meldet nvidia-smi ein Problem, vergleiche Kernel, DKMS-Status, Secure Boot und das Installationsprotokoll, bevor du weitere Installationswege vermischst.

Welche Daten und Verbindungen entstehen?

Das Skript enthält keinen vorgesehenen Diagnose-Upload und keine Cloud-Auswertung deiner Systemdaten. APT kontaktiert aber deine Paketquellen und lädt Pakete herunter. Beim fortgeschrittenen .run-Weg werden zusätzlich Metadaten und ein Installer von NVIDIA abgerufen. „Lokal ausgeführt“ bedeutet hier also nicht „offline“.

Das lokale Protokoll kann System- und Hardwareangaben enthalten. Teile bei einer Fehlermeldung nur die relevanten, geprüften Ausschnitte. Der Bash-Quellcode ist einsehbar; du kannst den Ablauf vor der Ausführung nachvollziehen.

Häufige Fragen

Installiert das Skript immer den neuesten NVIDIA-Treiber?

Im APT-Weg installiert es den verfügbaren Kandidaten aus den gewählten Debian-Quellen. Das muss nicht die neueste Veröffentlichung auf der NVIDIA-Website sein.

Richtet es Backports automatisch ein?

Nein. Die Backports-Option setzt passende eingerichtete Quellen voraus. Auch dort muss das benötigte Paket für deine Architektur vorhanden sein.

Kann ich damit auf Nouveau zurückwechseln?

Das Menü bietet das Entfernen installierter nvidia-*-Pakete und das Aktivieren von Nouveau an. Prüfe die gezeigte Paketliste. Diese Aktion ist kein vollständiger Rollback aller früheren, manuell vorgenommenen Grafikänderungen.

Mit einem nachvollziehbaren Installationsweg beginnen

Im NVIDIA-Debian-Projekt findest du das Skript, die Voraussetzungen und die Hinweise zur Fehlersuche. Wenn du Linux erst vorbereitest, starte mit der Checkliste für den Windows-zu-Linux-Umstieg und teste deine Hardware vor der Installation.

Quellen und technische Grundlage

Beschrieben ist der im Repository vorhandene Ablauf. Stand: 6. Oktober 2026.

• NVIDIA Driver: Projekt und README
• Installationsskript im Quellcode
• Debian: Paket nvidia-driver für Trixie
• Debian: Paket nvidia-cuda-toolkit für Trixie