====== Debian NVIDIA Installer ======

===== Übersicht =====
{{ :main-menu.png?300|}}
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 =====
{{ :drivers-menu.png?300|}}
  * **Abhängigkeits-Prüfung**: Verifiziert alle benötigten Pakete vor dem Start
  * **Fortschrittsanzeige**: Zeigt Prozentsatz während der Überprüfung
  * **Automatischer Sudo-Start**: Startet den Installer mit erhöhten Rechten
  * **Terminal-Integration**: Öffnet GNOME Terminal für interaktive Installation
  * **Entwicklermodus**: Unterstützt DEVENV-Umgebungsvariable für Tests

===== Bedienung =====

==== Programm starten ====


''./debian-nvidia-installer.sh''


Oder aus dem Anwendungsmenü starten.

==== Installations-Ablauf ====

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

===== Technische Details =====

==== Skript-Struktur ====

Das Skript besteht aus drei Hauptteilen:

**1. Abhängigkeits-Prüfung**
<code bash>
# 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 ',' ' ')
</code>

**2. Paket-Verifikation**
<code bash>
# 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
</code>

**3. Installer-Start**
<code bash>
# 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"
</code>

==== 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 =====

<WRAP left important 70%>
  * **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
</WRAP>

===== Installation =====

==== Als Debian-Paket ====

<code bash>
# Paket installieren (empfohlen)
sudo dpkg -i debian-nvidia-installer.deb

# Falls Abhängigkeiten fehlen
sudo apt-get install -f
</code>

==== Manuell (Entwicklung) ====

<code bash>
# 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
</code>

===== NVIDIA-Treiber auf Debian =====

==== Warum NVIDIA-Treiber? ====
{{ :post-installation-menu.png?300|}}
NVIDIA-Grafikkarten benötigen proprietäre Treiber für:
  * **3D-Beschleunigung**: Gaming und 3D-Anwendungen
  * **CUDA**: GPU-Computing für KI, Video-Encoding, etc.
  * **Vulkan/OpenGL**: Moderne Grafik-APIs
  * **Dual-Monitor**: Erweiterte Display-Optionen
  * **Power-Management**: Bessere Energieverwaltung

==== 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:

  * **build-essential**: Compiler und Build-Tools
  * **linux-headers-$(uname -r)**: Kernel-Header für DKMS
  * **dkms**: Dynamisches Kernel-Modul-System
  * **pkg-config**: Paket-Konfigurationstool
  * **libvulkan1**: Vulkan-Bibliothek
  * **mesa-vulkan-drivers**: Vulkan-Treiber (Fallback)
  * **vulkan-tools**: Vulkan-Debugging-Tools
  * **gnome-terminal**: Terminal-Emulator

===== Problembehandlung =====

==== "Missing dependency" Fehler ====

<code bash>
# 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
</code>

==== GNOME Terminal öffnet sich nicht ====

<code bash>
# 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
</code>

==== Installer startet nicht mit sudo ====

<code bash>
# Sudo-Rechte prüfen
sudo -v

# Falls sudo nicht installiert
su -c "env DEVENV=1 LOG_LEVEL=0 ./usr/bin/debian-nvidia-installer"
</code>

==== Nouveau-Konflikt ====

Nach der Installation muss nouveau deaktiviert werden:

<code bash>
# 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
</code>

==== NVIDIA-Treiber prüfen ====

Nach der Installation und Neustart:

<code bash>
# 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"
</code>

===== Nach der Installation =====

==== Nützliche NVIDIA-Tools ====

<code bash>
# NVIDIA X Server Settings (grafisches Tool)
nvidia-settings

# GPU-Monitoring
nvidia-smi -l 1  # Aktualisiert jede Sekunde

# CUDA-Version prüfen
nvcc --version
</code>

==== Prime-Unterstützung (Laptops) ====
{{:app-gpu-preferences-menu.png?400|}}
Für Laptops mit Intel + NVIDIA (Optimus):

<code bash>
# 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
</code>

===== Deinstallation =====

Falls der NVIDIA-Treiber entfernt werden soll:

<code bash>
# 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
</code>

===== 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 |