Fix NVIDIA Proprietary Driver Install Fails on Linux

Before you begin

Match the environmentUse this guide only for Windows 10, Windows 11 or a clearly compatible setup.

Protect recoveryBack up important data and save encryption or account recovery keys before changing system state.

Know when to stopMake one change at a time and stop if the result differs from what the guide describes.

Problem overview

When attempting to install the proprietary NVIDIA graphics drivers on a Linux distribution, the installation fails, or you boot into a black screen / blinking cursor. You are unable to access the desktop environment because the display server cannot start.

Common causes

The open-source nouveau driver is conflicting with the proprietary installation
Missing linux-headers required to compile the NVIDIA kernel modules via DKMS
Secure Boot is enabled in the BIOS, blocking unsigned proprietary kernel modules from loading

Solution 1: Disable Secure Boot

The NVIDIA proprietary driver is a third-party kernel module. Most Linux distributions do not sign it automatically.

Restart your PC and enter the BIOS/UEFI settings.
Locate the Secure Boot option (usually under the Security or Boot tabs).
Change Secure Boot to Disabled.
Save and exit the BIOS.

Solution 2: Blacklist the Nouveau driver

If you are stuck on a black screen, press Ctrl + Alt + F3 (or F4/F5) to switch to a TTY console and log in.
Open a terminal and run the following command to create a blacklist file:
```
sudo nano /etc/modprobe.d/blacklist-nouveau.conf
```

Add the following lines to the file:

blacklist nouveau
options nouveau modeset=0

Save the file (Ctrl+O, Enter) and exit nano (Ctrl+X).
Update the initramfs to apply the changes:
- On Ubuntu/Debian: sudo update-initramfs -u
- On Arch: sudo mkinitcpio -P
Reboot your system.

Solution 3: Install headers and the proprietary driver

Kernel modules require kernel headers to compile properly.

Install the linux-headers for your distribution:
- Ubuntu: sudo apt install linux-headers-$(uname -r)
- Arch: sudo pacman -S linux-headers
Install the NVIDIA drivers using the package manager (do not use the .run file from the NVIDIA website if possible):
- Ubuntu: sudo ubuntu-drivers autoinstall
- Arch: sudo pacman -S nvidia nvidia-utils
Reboot your computer.

Caution

If you are still booting to a black screen, edit your GRUB boot entry by pressing e during startup, find the line starting with linux, and append nomodeset to the end. Press F10 to boot. This will let you reach the desktop to troubleshoot further.

Confirm the result

Repeat the exact action that originally triggered the problem.

Confirm the original error or symptom is gone and no new warning has appeared.

If the guide changed a driver, service, package, or system setting, restart once and test again.

If the result is worse or unexpected, stop. Reverse only the last change using its documented restore option; if none is documented, use your backup or qualified support.

Questions about this fix

Why do I need to blacklist Nouveau?

Nouveau is the open-source NVIDIA driver pre-installed on most Linux distributions. If it is actively running, the proprietary driver cannot load correctly and the installation will fail.

What does nomodeset do?

Adding nomodeset to the GRUB boot parameters forces the kernel to not load video drivers until the X server starts, helping you bypass black screens to fix the drivers.

Fix NVIDIA Proprietary Driver Install Fails on Linux

Before you begin

Problem overview

Common causes

Solution 1: Disable Secure Boot

Solution 2: Blacklist the Nouveau driver

Solution 3: Install headers and the proprietary driver

Confirm the result

Questions about this fix

Weighted Consensus Protocol

Did this solution resolve your issue?

Discussion (0)

Join the Discussion