Windows How-To

Switch Display Protocol Between X11 and Wayland in Fedora

Learn how to switch your Fedora session between X11 and Wayland, verify your current protocol, and troubleshoot common issues for GNOME, KDE, and other desktops.

Learn how to switch your Fedora session between X11 and Wayland, verify your current protocol, and troubleshoot common issues for GNOME, KDE, and other desktops.

by Pallav Pathak

Switching between X11 and Wayland in Fedora directly impacts application compatibility, graphics performance, and access to certain system features. For users who need specific software support, such as screen sharing in Zoom, advanced monitor configuration, or legacy application compatibility, choosing the correct display protocol is essential. Below, you’ll find detailed instructions for identifying your current protocol, changing sessions, and resolving common switching issues in Fedora Workstation, KDE Plasma, and other desktop environments.

Checking Your Current Session Type

Open a terminal window. To determine whether your current session uses X11 or Wayland, enter the following command:
echo $XDG_SESSION_TYPE

This will output either x11 or wayland, indicating your active display protocol.

Alternatively, you can use loginctl to verify the session type. First, list your sessions:
loginctl

Identify your session ID (usually listed under your username), then run:

loginctl show-session <SESSION_ID> -p Type

This command will return the session type for the specified session.

Switching Between X11 and Wayland in GNOME (Fedora Workstation)

Save your work and log out of your current session.
At the login screen (GDM), click your username. Before entering your password, look for a gear icon or settings icon near the bottom right corner of the login box.
Click the gear icon to reveal available session options. You’ll typically see:
  • GNOME – launches a Wayland session.
  • GNOME on Xorg – launches an X11 session.
  • GNOME Classic and other variants depending on your installation.
Select your desired session type, enter your password, and log in. Your choice persists only for the current login; you’ll need to repeat this process if you want to switch again later.
If the gear icon or session options do not appear, you may need to ensure the required session files are present. For Wayland, check that /usr/share/wayland-sessions/gnome.desktop exists. For X11, confirm /usr/share/xsessions/gnome-xorg.desktop is available. If missing, reinstall the appropriate GNOME packages using dnf.

Switching Between X11 and Wayland in KDE Plasma (Fedora KDE Spin)

Log out of your current KDE session.
At the SDDM login screen, select your username. Locate the session selector, typically at the bottom left or right corner. Click it to display session options such as:
  • Plasma (Wayland)
  • Plasma (X11)
If the X11 session is not listed, you may need to install the X11 session components. Open a terminal (from a TTY if you cannot log in to Plasma), and run:
sudo dnf install plasma-workspace-x11 kwin-x11
After installing, reboot your system or log out and back in. The session selector should now offer both X11 and Wayland options.
Caution: KDE Plasma 6 and newer may default to Wayland, and Fedora may not install X11 session support by default. Some users have reported needing to reboot more than once for the new session to appear. If you encounter issues like missing wallpapers or unresponsive external monitors, a full reboot usually resolves them.

Setting the Default Session Type for Automatic Login

If you use automatic login, Fedora may not remember your last session choice. To set a persistent default, edit the display manager configuration.
For SDDM (KDE), add or modify the following line in /etc/sddm.conf or a file in /etc/sddm.conf.d/:
[General]
DisplayServer=x11

Save the file and reboot. This will set X11 as the default session for SDDM.

For GDM (GNOME), edit /etc/gdm/custom.conf and set:
WaylandEnable=true

Uncomment this line if necessary. To force X11, set WaylandEnable=false. Save the file and reboot to apply changes.

Switching Display Protocols in Other Desktop Environments

For environments like MATE or XFCE, X11 is typically the default. If you’re unsure, check your session type as described above.
If your login screen does not offer a session selector or gear icon, ensure the relevant session files exist in /usr/share/xsessions/ or /usr/share/wayland-sessions/. Reinstalling or updating your desktop environment package may restore missing session files.
For advanced configuration, you can edit /etc/sysconfig/desktop as root to set the default desktop and display manager for new users:
DESKTOP="KDE"
DISPLAYMANAGER="KDE"

This affects new user accounts and system defaults, but not per-user session selection.

Troubleshooting Common Issues When Switching

Session Not Appearing: If the X11 or Wayland session is missing from your login screen, verify that the necessary session packages are installed and that your system is fully updated. Reboot after installing new session packages.

Blank or Frozen Screen: Some users report a blank or unresponsive screen after switching protocols. In these cases, try rebooting two or three times. If the issue persists, revert your changes or select the previous session type at the login screen. Hardware compatibility, especially with graphics drivers (e.g., NVIDIA, AMD), may affect stability.

Application Compatibility: Not all applications run natively on Wayland. Some legacy or proprietary apps, like certain versions of Zoom or screen recorders, may require X11 for full functionality. In a Wayland session, these apps run through XWayland, which may limit features or cause bugs.

Screen Sharing and Remote Desktop: Screen sharing support is evolving in Wayland. If you need reliable screen sharing, X11 is often more dependable. Some applications require configuration changes (e.g., enabling PipeWire in Zoom) to work with Wayland.

Monitor Configuration Issues: Wayland restricts some monitor configuration and screen recording features for security reasons. If you require advanced monitor controls, X11 may provide broader support.

Verifying Active Protocol at Runtime: To confirm which protocol an application is using, you can check environment variables in a terminal:

echo $WAYLAND_DISPLAY
echo $DISPLAY

If WAYLAND_DISPLAY is set, you are on Wayland. If only DISPLAY is set, you are on X11. Some applications may run under XWayland in a Wayland session; tools like xwininfo or xprop can help you determine this.

Switching between X11 and Wayland in Fedora is straightforward once you know where to look for session selectors and how to install missing packages. If you run into issues, checking your session type and updating your system usually resolves most problems. For persistent compatibility needs, X11 remains available, but Wayland continues to gain stability and feature support with each Fedora release.

Keep reading

More from Windows

All Windows guides →