Ubuntu 20.04 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

The system accepts credentials but lands on a persistent black screen.

Environment & Reproduction

Mouse pointer may appear while desktop shell never loads fully.

Root Cause Analysis

Display manager failures, GPU driver conflicts, or corrupted user session cache are common causes.

Quick Triage

Switch to a TTY, confirm disk space and service status, and test a fallback session type.

Step-by-Step Diagnosis

Check journalctl -b, systemctl status gdm3, and user home permissions plus Xauthority state.

Solution – Primary Fix

Reinstall or reconfigure display manager and GPU packages, then clear stale user session cache.

Solution – Alternative Approaches

Boot with recovery mode, use a generic graphics driver, or create a new test user profile.

Verification & Acceptance Criteria

Desktop environment loads successfully and remains stable through logout and reboot cycles.

Rollback Plan

Revert recent graphics and display manager changes if new regressions appear.

Prevention & Hardening

Apply graphics updates carefully and keep sufficient free disk space for session files.

Related Errors & Cross-Refs

Related to login loop issues, NVIDIA driver mismatches, and Wayland compatibility problems.

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

Consult Ubuntu display manager and graphics troubleshooting documentation for Focal systems.