Ubuntu 26.04 LTS – NVIDIA driver update results in black screen after login

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Administrators observe: Ubuntu 26.04 LTS – NVIDIA driver update results in black screen after login. Desktop access and GPU workloads are interrupted.

Environment & Reproduction

Issue appears after driver transitions, kernel updates, or Wayland compatibility mismatches.

# Baseline context
lsb_release -a
uname -r
ubuntu-drivers devices
nvidia-smi || true
sudo journalctl -b -p err --no-pager | tail -n 120

Root Cause Analysis

Driver ABI mismatch, DKMS build failure, or display manager session conflict can prevent graphical session initialization.

Quick Triage

Switch to TTY and confirm installed driver packages and module status.

# Quick triage
dpkg -l | grep -Ei 'nvidia|cuda'
lsmod | grep nvidia || true
systemctl status gdm3 --no-pager
sudo dmesg | grep -Ei 'nvidia|nouveau' | tail -n 120

Step-by-Step Diagnosis

Validate DKMS output and Xorg/Wayland logs for failed module initialization.

# Detailed diagnosis
dkms status
sudo tail -n 120 /var/lib/dkms/nvidia/*/build/make.log 2>/dev/null || true
sudo journalctl -u gdm3 -n 120 --no-pager
cat /var/log/Xorg.0.log | tail -n 120 || true

Solution – Primary Fix

Purge broken NVIDIA stack and install recommended tested driver.

# Primary fix
sudo apt-get purge -y 'nvidia-*'
sudo ubuntu-drivers autoinstall
sudo update-initramfs -u -k all
sudo reboot

Solution – Alternative Approaches

Use open-source nouveau temporarily to restore desktop while planning driver reinstall.

# Alternative
sudo apt-get install -y xserver-xorg-video-nouveau
sudo rm -f /etc/modprobe.d/blacklist-nouveau.conf
sudo update-initramfs -u
sudo reboot

Verification & Acceptance Criteria

Graphical login succeeds and GPU tools report healthy driver/runtime state.

# Verify
loginctl
nvidia-smi
glxinfo -B | head -n 30 || true
systemctl is-active gdm3

Rollback Plan

Boot previous kernel or recovery mode and reinstall prior known-good driver version.

# Rollback
sudo apt-get install -y nvidia-driver-
sudo reboot

Prevention & Hardening

Pin validated driver versions for production desktops and GPU hosts.

# Hardening
apt-cache policy nvidia-driver-* | head -n 80
sudo apt-mark hold nvidia-driver- || true

Related Errors & Cross-Refs

Related patterns include login loop, gdm crash, and no devices were found from nvidia-smi.

Related tutorial: View the step-by-step tutorial for Ubuntu 26.04 LTS.

View all Ubuntu 26.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu graphics driver management and NVIDIA Linux driver installation guidance.