How to Install NVIDIA Drivers on Debian Linux

NVIDIA drivers unlock GPU acceleration for gaming, graphics rendering, and CUDA computational workloads on Debian. Proper driver installation ensures optimal performance and system stability, with installation complexity varying by Debian version due to different package availability and repository support.

This guide covers installing NVIDIA drivers on Debian 13 Trixie, Debian 12 Bookworm, and Debian 11 Bullseye using two primary methods: Debian’s default repositories for tested stability, and NVIDIA’s CUDA repository for cutting-edge drivers (Debian 12 and 11 only – Debian 13 Trixie currently lacks NVIDIA CUDA repository support). Installation procedures differ between Debian versions due to repository format changes and driver version availability, so follow the section matching your Debian release.

Choose Your NVIDIA Driver Installation Method

Debian provides two distinct paths for NVIDIA driver installation, each targeting different use cases and update preferences. Understanding the trade-offs between repository stability and feature currency helps you select the method that matches your hardware requirements and risk tolerance.

Method	Debian Version Support	Stability	Best For
Debian Default Repository	All supported Debian versions (13 Trixie, 12 Bookworm, 11 Bullseye)	High stability, conservative updates, thorough distribution testing	Production servers, conservative desktop setups, Debian 13 users (only option), users prioritizing reliability
NVIDIA CUDA Repository	Debian 12 Bookworm and 11 Bullseye only (Debian 13 Trixie NOT supported)	Cutting-edge features, frequent updates, minimal delay from NVIDIA release	Gaming with latest optimizations, machine learning workloads, CUDA development on Debian 12/11, newest GPU hardware support

NVIDIA currently publishes CUDA repositories for Debian 12 Bookworm and Debian 11 Bullseye only. Debian 13 Trixie lacks NVIDIA CUDA repository support, so Debian 13 users must use the default Debian repositories. Check the official NVIDIA CUDA repository listing for current version support.

The default Debian repository delivers drivers that undergo extensive distribution testing, making them ideal for production environments and the only option for Debian 13 users. The NVIDIA CUDA repository (Debian 12 and 11 only) provides immediate access to performance improvements, security patches, and hardware enablement for the latest GPU models, at the cost of reduced testing before reaching your system.

For most desktop users and gaming workloads on Debian 12 or 11, the NVIDIA CUDA repository offers the best balance of performance and hardware support. Debian 13 users, production servers, and risk-averse environments should favor Debian’s default repositories for their proven stability and integration with the distribution’s support lifecycle.

Pre-Installation Steps

Update System Packages

First, update your package index and upgrade existing packages to ensure kernel headers and dependencies match your current system state:

sudo apt update

Proceed to upgrade any outdated packages using the following command.

sudo apt upgrade

Remove Previous NVIDIA Driver Installations (If Switching Methods)

Mixing NVIDIA driver installation methods causes conflicts, especially when switching from Debian’s default repository to the NVIDIA CUDA repository or vice versa. If you previously installed drivers using one method and want to switch to another, removing the existing installation prevents package conflicts and system instability.

Choose the removal method that matches your previous installation:

Remove APT-Installed NVIDIA Drivers

Uninstall NVIDIA drivers installed through APT package manager:

sudo apt autoremove nvidia* --purge

Remove Runfile-Installed NVIDIA Drivers

Use the runfile uninstaller to remove NVIDIA drivers:

sudo /usr/bin/nvidia-uninstall

Remove CUDA Toolkit Runfile Installation

Clean up a CUDA toolkit installed via runfile (replace X.Y with your version):

sudo /usr/local/cuda-X.Y/bin/cuda-uninstall

Enable Contrib and Non-Free Repositories

NVIDIA drivers reside in Debian’s non-free repositories due to their proprietary licensing. Before installation, you must enable the contrib and non-free repositories. The command syntax changed in Debian 12 Bookworm with the introduction of the non-free-firmware component, so ensure you use the correct command for your Debian version.

Install the software-properties-common package to enable repository management commands:

sudo apt install software-properties-common -y

For Debian 12 Bookworm and newer releases:

sudo add-apt-repository contrib non-free non-free-firmware

For Debian 11 Bullseye and older releases:

sudo add-apt-repository contrib non-free

Once added, update your APT cache with the following command:

sudo apt update

Method 1: Install Nvidia Drivers via Debian Default Repository

Driver availability differs by release: On Debian 13 Trixie, driver versions 550.163.01 (primary) and 535.261.03 (Tesla 535 series) support Maxwell through Ada Lovelace architectures. Bookworm packages driver version 535.183.01 for Maxwell through Ampere GPUs, while Bullseye offers driver version 470.129.06 (primary) for Kepler through Ampere hardware plus legacy driver 390.144 for older Fermi and Kepler GPUs. Use nvidia-detect to identify which driver package your GPU requires.

NVIDIA drivers include proprietary firmware and closed-source components necessary for full GPU functionality. The drivers integrate with DKMS (Dynamic Kernel Module Support), which automatically rebuilds kernel modules when you install kernel updates, maintaining driver functionality across kernel upgrades without manual intervention.

Systems with Secure Boot enabled require enrolling a Machine Owner Key (MOK) to load DKMS-built kernel modules. Debian provides detailed instructions for MOK enrollment with DKMS and Secure Boot. Complete MOK enrollment before installing NVIDIA drivers to avoid rebuilding the kernel image. Alternatively, temporarily disable Secure Boot in BIOS/UEFI settings during installation.

Install Linux Kernel Headers

NVIDIA drivers compile kernel modules against your running kernel, requiring matching kernel headers. The safest approach installs headers that match the exact kernel you are running:

sudo apt install linux-headers-$(uname -r)

This command installs headers for the exact kernel version currently running, preventing DKMS build failures caused by mismatched header packages.

Alternatively, for 64-bit systems, install the headers directly:

sudo apt install linux-headers-amd64

On 32-bit systems (rare on modern hardware), specify the architecture manually. Non-PAE kernel systems (32-bit) use:

sudo apt install linux-headers-686

PAE kernel systems (32-bit with Physical Address Extension) use:

sudo apt install linux-headers-686-pae

Install NVIDIA Drivers Using nvidia-detect

The nvidia-detect utility analyzes your hardware and recommends the optimal driver package for your specific GPU model. Install nvidia-detect to identify the correct driver:

sudo apt install nvidia-detect

Run nvidia-detect to identify your NVIDIA GPU:

nvidia-detect

The output reveals your GPU model and recommends the optimal driver package for your hardware. In this example, the system features a GeForce GTX 1650 and recommends the nvidia-driver package, which is the correct choice for this GPU.

Install the recommended driver package along with required firmware:

sudo apt install nvidia-driver firmware-misc-nonfree

Debian 13 Trixie users have two driver options: the primary nvidia-driver package (version 550.x, recommended for most users) and nvidia-tesla-535-driver (version 535.x, older but tested). Both support Maxwell through Ada Lovelace GPUs. Debian 12 Bookworm and Debian 11 Bullseye ship a single primary driver version (535.x and 470.x respectively) via the nvidia-driver package. Use nvidia-detect’s recommendation unless you have specific compatibility requirements.

During installation, you’ll see a notification about the open-source Nouveau driver conflicting with NVIDIA’s proprietary driver. The system requires a reboot to unload Nouveau and activate the NVIDIA driver. Press the ENTER key to continue the installation, then reboot.

Before rebooting, optionally verify DKMS successfully built the kernel module:

sudo dkms status

The output should show the nvidia module with status “installed” for your running kernel. If DKMS reports build failures, troubleshoot before rebooting to avoid boot issues.

Reboot System to Activate Drivers

After installation completes, reboot your system to load the NVIDIA driver and disable Nouveau:

sudo reboot

Install Legacy Nvidia Drivers for Older GPUs

GPUs from the 400 series and older require legacy driver branches that Debian maintains separately. If nvidia-detect recommends a legacy driver, install the 390xx series instead of the standard nvidia-driver package:

sudo apt install nvidia-legacy-390xx-driver firmware-misc-nonfree

Reboot to activate the legacy drivers:

sudo reboot

The 340xx legacy driver series is available for GeForce 8 through GeForce 300 series GPUs, but Debian strongly discourages its use. This driver is no longer included in stable Debian releases, contains serious unfixable security vulnerabilities, and may not receive timely updates for new kernels. Use the open-source Nouveau driver instead if you require security and have hardware this old. The 340xx series should only be considered as a last resort when Nouveau cannot meet your specific needs.

Method 2: Install Nvidia Drivers via NVIDIA CUDA APT Repository

CRITICAL: NVIDIA currently publishes CUDA repositories for Debian 12 Bookworm and Debian 11 Bullseye ONLY. Debian 13 Trixie is NOT supported by NVIDIA’s CUDA APT repository. If you’re running Debian 13, use Method 1 (Debian Default Repository) instead. This section covers Debian 12 and 11 exclusively.

The NVIDIA CUDA APT repository delivers the latest proprietary and open-source drivers directly from NVIDIA, providing immediate access to new features, performance optimizations, and security patches as soon as they release. This method suits Debian 12 and 11 users who need cutting-edge GPU capabilities for machine learning, CUDA development, or gaming with the latest optimizations, and it includes full CUDA toolkit support for computational workloads.

Identify Your NVIDIA Graphics Card

Before installing drivers from the NVIDIA repository, verify your GPU model to ensure compatibility. Newer cards have guaranteed support, but older hardware may require specific driver versions. Use lspci to identify your NVIDIA GPU:

lspci | grep -e VGA

Example output:

03:00.0 VGA compatible controller: NVIDIA Corporation TU117 [GeForce GTX 1650] (rev a1)

Import NVIDIA GPG Key and Repository

Install the prerequisite packages for repository management and DKMS (Dynamic Kernel Module Support), which automatically rebuilds NVIDIA drivers when your kernel updates:

sudo apt install dirmngr ca-certificates software-properties-common apt-transport-https dkms curl -y

Download the NVIDIA GPG key directly in binary format and save it to the system keyring directory. Use the command matching your Debian version (Debian 12 or 11 only – skip this section if you’re on Debian 13):

Debian 12 Bookworm:

sudo curl -fsSLo /usr/share/keyrings/nvidia-drivers.gpg https://developer.download.nvidia.com/compute/cuda/repos/debian12/x86_64/3bf863cc.pub

Debian 11 Bullseye:

sudo curl -fsSLo /usr/share/keyrings/nvidia-drivers.gpg https://developer.download.nvidia.com/compute/cuda/repos/debian11/x86_64/3bf863cc.pub

Add NVIDIA CUDA APT Repository

Add the NVIDIA CUDA repository using the modern DEB822 format. Debian 12 Bookworm uses .sources files as standard, while Debian 11 Bullseye still primarily uses the legacy .list format but supports DEB822.

Debian 12 Bookworm:

echo "Types: deb
URIs: https://developer.download.nvidia.com/compute/cuda/repos/debian12/x86_64/
Suites: /
Signed-By: /usr/share/keyrings/nvidia-drivers.gpg" | sudo tee /etc/apt/sources.list.d/nvidia-drivers.sources

Debian 12 (Bookworm) is the oldest currently supported stable Debian version and uses the modern DEB822 .sources format shown above. All current and future Debian releases (12, 13 Trixie, and onwards) use this format as standard. Debian 11 (Bullseye) still uses the legacy .list format, so if running Debian 11, use the command provided below instead.

Debian 11 Bullseye:

echo 'deb [signed-by=/usr/share/keyrings/nvidia-drivers.gpg] https://developer.download.nvidia.com/compute/cuda/repos/debian11/x86_64/ /' | sudo tee /etc/apt/sources.list.d/nvidia-drivers.list

Verify the repository was added correctly by viewing the file:

cat /etc/apt/sources.list.d/nvidia-drivers.list

Choose Between Proprietary and Open-Source Driver Variants

Starting with driver version 515, NVIDIA publishes two kernel module flavors: proprietary (closed-source) and open (open-source kernel modules with closed-source firmware and userspace). The open variant targets newer hardware from Turing architecture forward, while the proprietary variant supports legacy hardware. Blackwell is the first architecture that requires the open variant exclusively.

Architecture support breakdown:

• Open variant: Turing (GTX 16/RTX 20 series), Ampere (RTX 30 series), Ada Lovelace (RTX 40 series), and Blackwell (RTX 50 series) architectures
• Proprietary variant: Maxwell (GTX 900/10 series), Pascal (GTX 10 series), Volta, Turing, Ampere, and Ada Lovelace architectures
• Legacy drivers (390xx, 340xx): Older architectures (Kepler, Fermi, etc.) not supported by current drivers

Most users should choose proprietary drivers for proven stability and full feature support. The open variant offers better Linux kernel integration but may have reduced performance on some GPU models. Choose open drivers when you need open-source licensing, better kernel compatibility, or have Blackwell-series hardware that requires them.

First, update your package cache to reflect the newly added repository:

sudo apt update

Install the latest NVIDIA drivers, choosing between proprietary or open-source versions. For comprehensive CUDA development environments including CUDA toolkit, libraries, and samples, refer to the dedicated CUDA installation guide for Debian.

Proprietary NVIDIA Drivers

sudo apt install nvidia-driver nvidia-settings

The nvidia-driver metapackage automatically installs nvidia-smi as a dependency at the correct matching version. Do not install nvidia-smi explicitly, as this can cause version conflicts between the driver and monitoring utility.

Open-Source NVIDIA Drivers

sudo apt install nvidia-driver nvidia-kernel-open-dkms nvidia-settings

The open kernel module variant requires driver branches 515 and newer. Debian 12 Bookworm (default or CUDA repository) provides these packages, but Debian 11’s default repository tops out at the 470 branch and cannot install nvidia-kernel-open-dkms, so use the proprietary package there unless you have added NVIDIA’s CUDA repository with a newer branch. If you have pre-existing NVIDIA drivers from a different installation method, the package manager will prompt you to remove them before proceeding. Select Yes to avoid driver conflicts that cause system instability.

Reboot

During the final phase of the installation, most users will typically see a message like the image below:

To activate the installation, reboot your system. You can use the following command after completing the installation:

sudo reboot

Specialized Installation Options

NVIDIA supports specialized installations that limit components to reduce system footprint and dependencies. These options target specific use cases where full desktop graphics or compute capabilities aren’t needed.

Compute-Only Installation (Headless Servers)

For GPU compute workloads without desktop graphics (machine learning servers, rendering farms, scientific computing clusters), install only the compute components to minimize dependencies and system resources:

sudo apt install nvidia-driver-cuda nvidia-kernel-dkms

This excludes OpenGL, EGL, Vulkan, and X server drivers while retaining CUDA and compute capabilities. The installation remains minimal and focused on computational tasks.

Desktop-Only Installation (No Compute)

For systems using NVIDIA GPUs purely for desktop graphics without CUDA or compute requirements (office workstations, general desktop use):

sudo apt install nvidia-driver nvidia-kernel-dkms

This installs graphics drivers, OpenGL, Vulkan, and X server components while omitting CUDA libraries and compute frameworks. Components excluded at installation time can be added later by installing the appropriate packages.

Install 32-bit Support for NVIDIA Drivers

Many 32-bit applications and games (particularly through Steam or Wine) require 32-bit NVIDIA libraries even on 64-bit systems. Enable multilib support and install the corresponding 32-bit driver libraries matching your installed driver version.

Enable 32-bit architecture support:

sudo dpkg --add-architecture i386
sudo apt update

Install 32-bit libraries for the primary nvidia-driver package:

sudo apt install nvidia-driver-libs:i386

If you installed a legacy driver instead of the standard nvidia-driver package, install the corresponding 32-bit libraries: nvidia-legacy-390xx-driver-libs:i386 for the 390xx series, or nvidia-legacy-340xx-driver-libs:i386 for the 340xx series. Match the 32-bit library package to your installed driver version to avoid conflicts.

Restart your applications (or reboot your system) to activate the 32-bit NVIDIA libraries. Steam and Wine applications now have access to proper GPU acceleration through the 32-bit library stack.

Confirm NVIDIA Drivers Installation

Verify NVIDIA Drivers via CLI Command

Verify the installation by running nvidia-smi, NVIDIA’s System Management Interface utility:

nvidia-smi

Successful installation displays GPU model, driver version, CUDA version, and current GPU utilization. If this command fails or reports no NVIDIA devices, verify that /dev/nvidia* device files exist with correct permissions and confirm the nouveau driver is blacklisted.

For systems with compute capabilities, NVIDIA recommends testing GPU communication with the cuda-samples repository. The deviceQuery and bandwidthTest utilities confirm proper CUDA operation and validate that the driver, CUDA runtime, and GPU hardware communicate correctly for computational workloads. Download and build the samples following the repository instructions to perform comprehensive verification beyond basic driver detection.

The nvidia-smi output provides essential system information:

Verify NVIDIA Drivers via GUI

Open the NVIDIA Settings GUI using the following command:

nvidia-settings

Or launch the application icon from the applications menu:

Activities > Show Applications > NVIDIA X Server

The interface displays all NVIDIA driver settings and system information, confirming successful installation.

Additional screenshots show the NVIDIA Settings GUI interface for users new to Linux:

Configure Wayland Support (Optional)

Debian 12 Bookworm and newer default to Wayland sessions for GNOME and KDE Plasma desktops. Wayland is the modern display server that offers improved security, better performance, and stronger isolation compared to the legacy X11 server. NVIDIA driver version 495+ supports Wayland, but proper configuration ensures display managers recognize the driver and enable Wayland sessions. Most users should configure Wayland support to benefit from these improvements. Skip this section only if you deliberately use X11 exclusively.

Enable Kernel Modesetting

Check if NVIDIA kernel modesetting is enabled:

cat /sys/module/nvidia_drm/parameters/modeset

If the output shows N, enable modesetting by adding the parameter to the NVIDIA module configuration:

echo "options nvidia-drm modeset=1" | sudo tee -a /etc/modprobe.d/nvidia-options.conf

Update the initramfs to apply the change:

sudo update-initramfs -u

Enable Power Management for Suspend and Resume

GNOME on Wayland requires video memory preservation for proper suspend/resume functionality and Wayland session availability. Enable the power management parameter:

echo "options nvidia NVreg_PreserveVideoMemoryAllocations=1" | sudo tee -a /etc/modprobe.d/nvidia-power-management.conf

Skip the NVreg_PreserveVideoMemoryAllocations parameter if you have Optimus hybrid graphics (Intel + NVIDIA). Hybrid systems require different power management configurations covered in dedicated Optimus guides.

Install and enable NVIDIA suspend/hibernate systemd services:

sudo apt install nvidia-suspend-common
sudo systemctl enable nvidia-suspend.service
sudo systemctl enable nvidia-hibernate.service
sudo systemctl enable nvidia-resume.service

Reboot your system to apply all Wayland configuration changes:

sudo reboot

After rebooting, verify modesetting is enabled (Y output) and your display manager offers Wayland sessions at login.

Dracut Configuration (Debian 13 Trixie Systems)

Debian 13 Trixie uses dracut for initramfs generation instead of initramfs-tools. Systems using dracut require explicit modprobe configuration file inclusion to ensure NVIDIA drivers load correctly during early boot. Skip this section if you use Debian 12 or 11.

Create a dracut configuration file that includes NVIDIA modprobe settings:

echo 'install_items+=" /etc/modprobe.d/nvidia-blacklists-nouveau.conf /etc/modprobe.d/nvidia.conf /etc/modprobe.d/nvidia-options.conf "' | sudo tee /etc/dracut.conf.d/10-nvidia.conf

The spaces inside the quotes are required for proper syntax. These modprobe configuration files are created automatically by the nvidia-driver package installation.

Configure dracut before installing NVIDIA drivers to avoid boot issues. If you already installed drivers without this configuration, create the dracut config file and rebuild your initramfs:

sudo dracut --force

Advanced Configuration Options

Lock Driver to Specific Version or Branch (Optional)

By default, Debian’s package manager updates NVIDIA drivers when newer versions become available. For production systems or environments requiring stability, NVIDIA provides version-locking packages that prevent automatic driver upgrades. These packages pin your system to track a specific driver branch (e.g., 535.x series) or exact version.

To lock your system to a specific branch:

sudo apt install nvidia-driver-pinning-<branch>

To lock to an exact driver version:

sudo apt install nvidia-driver-pinning-<version>

For example, sudo apt install nvidia-driver-pinning-535 locks to the 535.x branch, preventing upgrades to 550.x or later. Version pinning suits scenarios where application compatibility matters more than bleeding-edge features, or when validating driver stability before production deployment.

Install the pinning package before installing the driver for cleanest results. Pinning packages work with both Debian repository and NVIDIA CUDA repository installations. For detailed version locking documentation, consult NVIDIA’s official version locking guide.

Troubleshooting Common NVIDIA Driver Issues

Black Screen or No Display After Installation

If your system boots to a black screen after installing NVIDIA drivers, the Nouveau driver may still be loading or the display manager failed to start. Boot into recovery mode or a virtual console (Ctrl+Alt+F3) and verify the driver loaded correctly:

lsmod | grep nvidia

If no output appears, the driver failed to load. Additionally, check DKMS build status:

sudo dkms status

Rebuild the driver if needed:

sudo dkms autoinstall

Secure Boot Conflicts

Systems with Secure Boot enabled block unsigned kernel modules, preventing NVIDIA drivers from loading. You have two options: disable Secure Boot in BIOS/UEFI settings, or enroll a Machine Owner Key (MOK) to sign DKMS-built modules.

For MOK enrollment, Debian provides comprehensive instructions for signing DKMS modules with Secure Boot enabled. The enrollment process involves generating a key pair, registering the public key with the system firmware, and configuring DKMS to automatically sign modules during builds. This approach maintains Secure Boot protection while allowing custom kernel modules.

For most users, temporarily disabling Secure Boot in BIOS/UEFI settings during driver installation provides the simplest path forward. Re-enable Secure Boot after confirming drivers work correctly, or complete MOK enrollment if you need Secure Boot active.

DKMS Build Failures After Kernel Updates

If DKMS fails to rebuild drivers after a kernel update, ensure kernel headers match your running kernel:

uname -r

sudo apt install linux-headers-$(uname -r)

Then force DKMS to rebuild:

sudo dkms autoinstall && sudo update-initramfs -u

Nouveau Driver Conflicts

If the proprietary NVIDIA driver and open-source Nouveau driver load simultaneously, blacklist Nouveau permanently. Create a blacklist configuration file:

echo "blacklist nouveau
options nouveau modeset=0" | sudo tee /etc/modprobe.d/blacklist-nouveau.conf

Update the initramfs and reboot:

sudo update-initramfs -u && sudo reboot

Performance Issues or GPU Not Detected

Verify the NVIDIA driver recognizes your GPU and displays correct power management state:

nvidia-smi -q | grep -E "Product Name|Performance State"

For laptops with hybrid graphics (Intel + NVIDIA), the system may not automatically use the discrete GPU. Install nvidia-prime for GPU switching and select the NVIDIA GPU as primary:

sudo apt install nvidia-prime
sudo prime-select nvidia

Optimus hybrid graphics systems require additional configuration beyond standard driver installation. Debian provides detailed NVIDIA Optimus setup instructions covering PRIME profiles, render offloading, and power management specific to hybrid graphics configurations.

Conclusion

NVIDIA driver installation on Debian delivers full GPU acceleration for gaming, graphics rendering, machine learning, and CUDA computational workloads. Debian’s default repositories provide stable, tested drivers suitable for production environments, while NVIDIA’s CUDA repository (Debian 12 and 11 only) offers cutting-edge features and immediate security patches for development workloads. DKMS automatically rebuilds drivers during kernel updates, maintaining consistent GPU functionality across system upgrades. Wayland support requires kernel modesetting and power management configuration on Debian 12+ systems, while Debian 13 Trixie users need dracut configuration for proper initramfs integration. Your Debian system now runs production-ready NVIDIA drivers verified through nvidia-smi, with GPU acceleration available immediately for gaming, CUDA development, machine learning frameworks, or graphics rendering. You are ready to unlock the full computational power of your hardware.