Black Screen After NVIDIA Driver Install

📖 ~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

System boots to a black screen or login loop, blocking local GUI access.

Environment & Reproduction

Ubuntu 20.04 desktop/laptop after installing proprietary NVIDIA packages or changing kernel versions.

Root Cause Analysis

Driver, kernel module, and display stack components are mismatched or secure boot blocks module loading.

Quick Triage

Switch to TTY, inspect `nvidia-smi` and module load status, and verify display manager health.

Step-by-Step Diagnosis

Review Xorg and journal logs, DKMS build output, and secure boot enrollment state.

Solution – Primary Fix

Install recommended driver version, rebuild modules, and re-enable display manager after cleanup.

Solution – Alternative Approaches

Fallback to open-source `nouveau` temporarily or pin a known stable kernel-driver combination.

Verification & Acceptance Criteria

GUI session loads normally, GPU acceleration is available, and logs show no fatal graphics errors.

Rollback Plan

Purge proprietary driver and restore prior graphics stack if display stability is not achieved.

Prevention & Hardening

Use tested driver channels and validate DKMS build results before rebooting production desktops.

Related Errors & Cross-Refs

`Failed to start gdm`, `NVRM` errors, and secure boot module signature failures.

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

View all Ubuntu 20.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu graphics driver documentation and NVIDIA compatibility guidance for 20.04 kernels.