Xorg Display Errors — X Server Crashes, Black Screen, and Resolution Issues

Fix Xorg display server errors including X server crashes, black screen after login, resolution detection failures, and multi-monitor configuration problems. This guide covers everything you need to know about this topic, including common causes, step-by-step solutions, and answers to frequently asked questions.

Here are the key things to understand: Xorg (X11) is the traditional display server for Linux desktop environments. Xorg logs are in /var/log/Xorg.0.log — lines starting with (EE) are errors. Configuration files in /etc/X11/xorg.conf and /etc/X11/xorg.conf.d/. Common crash causes: wrong GPU driver, missing firmware, incompatible monitor resolution. xrandr is the primary tool for managing display resolution and multi-monitor layouts. Understanding these fundamentals will help you diagnose and resolve this issue more effectively.

The most common reasons this occurs include: GPU driver not installed or incompatible with the kernel version. Missing GPU firmware blobs (/lib/firmware/ missing files for your GPU). xorg.conf specifying a resolution or refresh rate not supported by the monitor. NVIDIA/AMD proprietary driver conflict with the open-source Nouveau/AMDGPU driver. Multi-monitor setup with mismatched resolutions causing layout errors. Identifying the root cause is the first step toward finding the right solution.

To resolve this, follow these recommended steps: Check Xorg log for errors: grep '(EE)' /var/log/Xorg.0.log. Install the correct GPU driver: nvidia-driver (NVIDIA), mesa (AMD/Intel open-source), amdgpu-pro (AMD proprietary). Test a basic configuration: sudo Xorg :1 -configure to generate a test xorg.conf. Use xrandr to list available resolutions: xrandr --listmonitors and xrandr --output HDMI-1 --mode 1920x1080. For black screen: switch to TTY (Ctrl+Alt+F2), login, and check Xorg log. Delete custom xorg.conf: mv /etc/X11/xorg.conf /etc/X11/xorg.conf.bak to use auto-detection. If these steps do not resolve the issue, consider consulting additional resources or a qualified professional.

This article is part of our Linux Error Codes collection on Error Codes Wiki. We provide comprehensive, up-to-date information to help you find solutions quickly.