English Portuguese (Portugal)
How to debug Wayland problems
'''
This page was automatically converted from https://fedoraproject.org/wiki/How_to_debug_Wayland_problems
It is probably
Badly formatted
Missing graphics and tables that do not convert well from mediawiki
Out-of-date
In need of other love
Pull requests accepted at https://pagure.io/fedora-docs/quick-docs
Once you've fixed this page, remove this notice, and update [filename]`modules/ROOT/nav.adoc`.
Once the document is live, go to the original wiki page and replace its text with the following macro:
{{#fedoradocs: https://docs.fedoraproject.org/whatever-the-of-this-new-page}}
'''
https://en.wikipedia.org/wiki/Wayland_%28display_server_protocol%29[Wayland] is intended as a simpler replacement for https://en.wikipedia.org/wiki/X_Window_System[X11]. Wayland changes the design of a Linux desktop architecture considerably. Unlike X11, there is no dedicated standalone server in Wayland. What was previously done between the app, its toolkit, the Xserver and the window manager is now shared between the app, its toolkit and the Wayland compositor which manages the compositing, input, windows management, etc. The apps and toolkits are now in charge of their own rendering and decorations (client side decorations), so any issues usually sit between the toolkit (e.g. GTK+) and the Wayland compositor (e.g. mutter).
You can read more about Wayland on the GNOME https://wiki.gnome.org/Initiatives/Wayland[Wayland initiative] wiki page. You can read more about the current state of Wayland features on link:Wayland_features[Wayland features] page.
Identifying Wayland problems
Are you running a Wayland session?
In *GNOME*, there's a gear button at the login screen which can be used to either log into a Wayland session (simply called _GNOME_, it's the default option), or a legacy X11 session (called _GNOME on Xorg_). If you have a password-less user account, you won't see the gear icon, it is displayed only when the password prompt appears. Use the gear button to determine type of session you're logging into. If you want to start your session in a different way, read https://wiki.gnome.org/Initiatives/Wayland/TryingIt[the advanced techniques for trying Wayland].
image:gdm-pick-wayland.png[gdm-pick-wayland.png,title="gdm-pick-wayland.png",width=400]
In *KDE*, there is support for running a nested Wayland session inside your X11 session. You'll need to install `kwin-wayland` package and then follow up with https://community.kde.org/KWin/Wayland[this howto]. There doesn't seem to be out-of-the-box support for running a full Wayland session at the moment.