Inhaltsverzeichnis

Debian NVIDIA Installer

Übersicht

Der Debian NVIDIA Installer ist ein Bash-Wrapper-Skript zur Installation von NVIDIA-Treibern auf Debian-basierten Systemen wie GuideOS.

Zweck

Das Skript dient als Wrapper für den eigentlichen NVIDIA-Installer. Es überprüft zunächst alle erforderlichen Abhängigkeiten aus der Debian-Paket-Control-Datei und startet dann den Hauptinstaller in einem GNOME Terminal mit sudo-Rechten.

Funktionen

Bedienung

Programm starten

./debian-nvidia-installer.sh

Oder aus dem Anwendungsmenü starten.

Installations-Ablauf

  1. Skript starten
  2. Abhängigkeits-Prüfung läuft automatisch:
    • Liest Abhängigkeiten aus DEBIAN/control
    • Prüft jedes Paket einzeln
    • Zeigt Fortschritt in Prozent
  3. Bei fehlenden Abhängigkeiten: Fehlermeldung und Abbruch
  4. Bei erfolgreicher Prüfung: GNOME Terminal öffnet sich
  5. Hauptinstaller startet automatisch mit sudo
  6. Folgen Sie den Anweisungen im Terminal

Technische Details

Skript-Struktur

Das Skript besteht aus drei Hauptteilen:

1. Abhängigkeits-Prüfung

# Liest Depends aus DEBIAN/control
depends_line=$(grep -E '^Depends:' "./DEBIAN/control" | head -n1)
 
# Konvertiert zu Array
depends_list=${depends_line#Depends:}
depends_list=$(echo "$depends_list" | tr -d ' ')
depends_list=$(echo "$depends_list" | tr ',' ' ')

2. Paket-Verifikation

# Prüft jedes Paket mit packages::is_installed
for pkg in "${depends_list[@]}"; do
  if ! packages::is_installed "$pkg"; then
    echo "Missing dependency: $pkg"
    exit 1
  fi
done

3. Installer-Start

# Startet Installer in GNOME Terminal mit sudo
exec gnome-terminal --title="Terminal" -- bash -c   "sudo env DEVENV=1 LOG_LEVEL=0 ./usr/bin/debian-nvidia-installer; exec bash"

Verwendete Dateien

Datei Zweck
debian-nvidia-installer.sh Wrapper-Skript (dieser Artikel)
usr/lib/debian-nvidia-installer/packages.sh Hilfsfunktionen für Paket-Prüfung
usr/bin/debian-nvidia-installer Eigentlicher NVIDIA-Installer
DEBIAN/control Debian-Paket-Metadaten mit Abhängigkeiten

Umgebungsvariablen

Variable Wert Bedeutung
DEVENV 1 Entwicklermodus aktivieren
LOG_LEVEL 0 Log-Level (0 = minimal)

Wichtige Hinweise

  • Wrapper-Skript: Dies ist nur der Starter, nicht der eigentliche Installer
  • Abhängigkeiten: Alle in DEBIAN/control genannten Pakete müssen installiert sein
  • Sudo-Rechte: Der Installer benötigt Administratorrechte
  • GNOME Terminal: Muss installiert sein (auf GuideOS vorhanden)
  • Neustart: Nach erfolgreicher Installation ist meist ein Neustart erforderlich
  • Nouveau-Konflikt: Der Open-Source-Treiber nouveau muss deaktiviert werden

Installation

Als Debian-Paket

# Paket installieren (empfohlen)
sudo dpkg -i debian-nvidia-installer.deb
 
# Falls Abhängigkeiten fehlen
sudo apt-get install -f

Manuell (Entwicklung)

# Skript ausführbar machen
chmod +x debian-nvidia-installer.sh
 
# Paket-Struktur muss vorhanden sein:
# ./DEBIAN/control
# ./usr/lib/debian-nvidia-installer/packages.sh
# ./usr/bin/debian-nvidia-installer
 
# Ausführen
./debian-nvidia-installer.sh

NVIDIA-Treiber auf Debian

Warum NVIDIA-Treiber?

NVIDIA-Grafikkarten benötigen proprietäre Treiber für:

Nouveau vs. NVIDIA

Merkmal Nouveau (Open Source) NVIDIA (Proprietary)
Performance Deutlich langsamer Volle Leistung
3D-Beschleunigung Eingeschränkt Vollständig
CUDA Nicht verfügbar Verfügbar
Power-Management Eingeschränkt Optimal
Stabilität Gut für Desktop Sehr gut
Installation Automatisch Manuell erforderlich

Typische Abhängigkeiten

Der Installer benötigt typischerweise folgende Pakete:

Problembehandlung

"Missing dependency" Fehler

# Fehlende Abhängigkeiten installieren
sudo apt update
sudo apt install build-essential linux-headers-$(uname -r) dkms
 
# Control-Datei prüfen
cat DEBIAN/control | grep Depends

GNOME Terminal öffnet sich nicht

# GNOME Terminal installieren
sudo apt install gnome-terminal
 
# Alternativ: Direkt im aktuellen Terminal ausführen
sudo env DEVENV=1 LOG_LEVEL=0 ./usr/bin/debian-nvidia-installer

Installer startet nicht mit sudo

# Sudo-Rechte prüfen
sudo -v
 
# Falls sudo nicht installiert
su -c "env DEVENV=1 LOG_LEVEL=0 ./usr/bin/debian-nvidia-installer"

Nouveau-Konflikt

Nach der Installation muss nouveau deaktiviert werden:

# Nouveau auf Blacklist setzen
echo "blacklist nouveau" | sudo tee /etc/modprobe.d/blacklist-nouveau.conf
echo "options nouveau modeset=0" | sudo tee -a /etc/modprobe.d/blacklist-nouveau.conf
 
# Initramfs neu erstellen
sudo update-initramfs -u
 
# System neu starten
sudo reboot

NVIDIA-Treiber prüfen

Nach der Installation und Neustart:

# NVIDIA-Treiber-Version prüfen
nvidia-smi
 
# Geladene Kernel-Module prüfen
lsmod | grep nvidia
 
# OpenGL-Renderer prüfen
glxinfo | grep "OpenGL renderer"
 
# Vulkan prüfen
vulkaninfo | grep "deviceName"

Nach der Installation

Nützliche NVIDIA-Tools

# NVIDIA X Server Settings (grafisches Tool)
nvidia-settings
 
# GPU-Monitoring
nvidia-smi -l 1  # Aktualisiert jede Sekunde
 
# CUDA-Version prüfen
nvcc --version

Prime-Unterstützung (Laptops)

Für Laptops mit Intel + NVIDIA (Optimus):

# Prime-Profile auflisten
prime-select query
 
# Zu NVIDIA wechseln
sudo prime-select nvidia
 
# Zu Intel wechseln (Energiesparen)
sudo prime-select intel
 
# Neustart nach Wechsel
sudo reboot

Deinstallation

Falls der NVIDIA-Treiber entfernt werden soll:

# NVIDIA-Pakete entfernen
sudo apt purge nvidia-*
 
# Nouveau-Blacklist entfernen
sudo rm /etc/modprobe.d/blacklist-nouveau.conf
 
# Initramfs neu erstellen
sudo update-initramfs -u
 
# System neu starten
sudo reboot

Alternativen

Methode Vorteile Nachteile
Debian-Paket Einfach, automatische Updates Möglicherweise ältere Treiber
NVIDIA .run Neueste Treiber Manuelle Installation, keine Updates
nvidia-installer Offiziell von NVIDIA Komplexer
Dieses Tool Automatisiert, geführt GuideOS-spezifisch

Lizenz

Dateiname debian-nvidia-installer.sh
Typ Wrapper-Skript
Funktion Startet NVIDIA-Treiber-Installation
Lizenz GPL3