Nouveau, the open source driver, is fine for a desktop and hopeless for gaming. For Vulkan, Proton and CUDA you want NVIDIA's proprietary driver. There are two ways to get it, and they should not be mixed on the same machine.
First, identify the card
lspci | grep -i nvidia
uname -r # your running kernel version
lsmod | grep nouveau # is the open driver loaded?
nvidia-smi # if this works, a driver is already installed
Note the model — a GTX 1050, an RTX 3060, a Quadro — and the kernel version. Both matter below.
Method 1: the .run installer from NVIDIA
This is the method that gives you exactly the driver version NVIDIA published, independent of what the distribution ships. It also means you rebuild the kernel module yourself after every kernel update unless you use DKMS, so read the whole section before starting.
1. Download the driver
Go to nvidia.com/Download/index.aspx and fill in the form: your product type,
product series, the exact GPU model and Operating System: Linux 64-bit. Download
the .run file — for example NVIDIA-Linux-x86_64-580.65.06.run. The
version number will differ; use whatever NVIDIA gives you for your card.
2. Install the build tools
sudo apt update
sudo apt install linux-headers-$(uname -r) build-essential dkms libglvnd-dev pkg-config
Without matching kernel headers the installer cannot build the module, and it will fail halfway with a compiler error.
3. Disable Nouveau
The two drivers cannot both claim the card. Create a blacklist file:
sudo tee /etc/modprobe.d/blacklist-nouveau.conf <<'EOF'
blacklist nouveau
options nouveau modeset=0
EOF
sudo update-initramfs -u
sudo reboot
After the reboot, lsmod | grep nouveau should print nothing. If it still shows up,
the initramfs was not rebuilt — repeat sudo update-initramfs -u.
4. Drop to a text console
The installer cannot replace a driver that a running graphical session is using. Stop the display manager first:
sudo systemctl isolate multi-user.target
You will land on a black screen with a login prompt. Log in as your normal user.
5. Run the installer
cd ~/Downloads
chmod +x NVIDIA-Linux-x86_64-*.run
sudo ./NVIDIA-Linux-x86_64-*.run
Answer the prompts:
- DKMS kernel module? Yes. This rebuilds the module automatically when the kernel changes.
- 32-bit compatibility libraries? Yes if you use Steam — a large part of the library is still 32-bit.
- Run nvidia-xconfig? No, unless you have an unusual multi-GPU or X11 setup. Modern Plasma generates its own configuration.
6. Reboot and check
sudo reboot
nvidia-smi
A table with your GPU, driver version and memory use means it worked. If you are stuck in a
text console, sudo systemctl set-default graphical.target and reboot.
Secure Boot. With Secure Boot enabled, an unsigned kernel module is rejected
and you get a black screen or a fallback to Nouveau. Either disable Secure Boot in the firmware,
or sign the module with mokutil — the installer offers to do this and asks you to
set a one-time password you then enter in the blue MOK screen at the next boot.
Method 2: the distribution repository
For most people this is the better option: the driver arrives through normal updates, is rebuilt for each kernel automatically, and can be removed with one command.
# Debian: make sure contrib, non-free and non-free-firmware are enabled
sudo apt edit-sources
# then install the current driver plus the firmware blobs
sudo apt update
sudo apt install nvidia-driver firmware-misc-nonfree
sudo reboot
On Ubuntu-based systems the equivalent one-liner is:
sudo ubuntu-drivers autoinstall
Verify with nvidia-smi, exactly as above.
Do not mix the two methods. Installing the repository package over a
.run installation (or the reverse) leaves files from both drivers on disk and
produces confusing failures. Remove one properly before installing the other:
sudo ./NVIDIA-Linux-x86_64-*.run --uninstall, or
sudo apt purge '^nvidia-.*' followed by sudo apt autoremove.
Wayland or X11
Plasma offers both sessions at the login screen. NVIDIA on Wayland works well on current drivers and gives smoother scrolling and per-monitor scaling; X11 remains the fallback if you see flicker, broken screen sharing or games that will not go fullscreen. Switch sessions from the login screen's session menu — nothing is lost either way.
Troubleshooting
| Symptom | Fix |
|---|---|
| Black screen after reboot | Ctrl+Alt+F3 for a text console, then sudo ./NVIDIA-Linux-*.run --uninstall and reinstall. Often caused by Secure Boot. |
nvidia-smi: command not found | The install did not complete. Check dkms status for a failed build, then reinstall the headers. |
| Driver breaks after a kernel update | DKMS was declined at install time. Re-run the installer with --dkms. |
| Nouveau still loads | The blacklist file is wrong or the initramfs is stale: sudo update-initramfs -u and reboot. |
| Hybrid laptop: games use the integrated GPU | Run with __NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia %command% as a Steam launch option, or switch the whole session with prime-select nvidia. |
| Tearing in games | Enable Force full composition pipeline in the NVIDIA settings, or turn on VRR in Plasma's display settings. |