Plasma/Wayland/Nvidia: Difference between revisions

Latest revision as of 15:07, 28 September 2024

Here's how to run with the proprietary Nvidia driver on Wayland:

Prerequisites

To use the Plasma Wayland session:

Use an up-to-date version of Plasma (explicit sync support was implemented in 6.1)
Ensure a reasonably new NVIDIA driver:
- minimum supported by KWin is 495.44;
- XWayland apps are usable with 555 and newer.
You need to have the Nvidia EGL library installed. It can be a separate package (libnvidia-egl-wayland1) or bundled with the driver package (e.g. nvidia-gl-G06 on openSUSE since 555).
To run XWayland apps without flickering, at least XWayland 24.1 is required.

Use the modesetting driver

Check whether the driver is running in modesetting mode:

cat /sys/module/nvidia_drm/parameters/modeset

It should print “Y”. If not, modify your kernel command line and add the line nvidia_drm.modeset=1. Search for “kernel parameters” in your distribution; https://wiki.archlinux.org/index.php/Kernel_parameters is a good starting point.

It is also possible to pass the parameter via module configuration:

echo options nvidia_drm modeset=1 | sudo tee /etc/modprobe.d/nvidia_drm.conf

You need to regenerate the initramfs in case your distribution provides the graphics drivers in initramfs (e.g. sudo update-initramfs -u)

Login

Select “Plasma (Wayland)” from your login manager
Enjoy your beautiful super-fast accelerated Wayland desktop!

Known Limitations

Night Color is not applied to the mouse cursor: https://bugs.kde.org/show_bug.cgi?id=479889
Poor performance on external screens on hybrid GPU setups when using NVIDIA GPU as a secondary GPU because it requires CPU copying from the primary GPU to the secondary GPU (see https://invent.kde.org/plasma/kwin/-/merge_requests/1031, https://bugs.kde.org/show_bug.cgi?id=452219)

@@ Line 1: / Line 1: @@
-Running Nvidia Wayland
+Here's how to run with the '''proprietary''' Nvidia driver on Wayland:
-* You need a very up-to-date Qt. Make sure you have > Qt5.15.0 or 4bd13402f0293e85b8dfdf92254e250ac28094c7 cherry-picked.
+=== Prerequisites ===
-* Check our driver is running in modesettings mode
+To use the Plasma Wayland session:
-"cat /sys/module/nvidia_drm/parameters/modeset"
+* Use an up-to-date version of Plasma (explicit sync support was implemented in 6.1)
+* Ensure a reasonably new NVIDIA driver:
+** minimum supported by KWin is 495.44;
+** XWayland apps are usable with 555 and newer.
+* You need to have the Nvidia EGL library installed. It can be a separate package (<code>libnvidia-egl-wayland1</code>) or bundled with the driver package (e.g. <code>nvidia-gl-G06</code> on openSUSE since 555).
+* To run XWayland apps without flickering, at least XWayland 24.1 is required.
-It should print "Y"
+=== Use the modesetting driver===
+Check whether the driver is running in modesetting mode:
-If so, you can skip the next step
+<code>cat /sys/module/nvidia_drm/parameters/modeset</code>
-* Modify your kernel command line.
+It should print “Y”. If not, modify your kernel command line and add the line <code>nvidia_drm.modeset=1</code>.
-Search for "kernel parameters" in your distribution and add the line "nvidia-drm.modeset=1"
+Search for “kernel parameters” in your distribution; https://wiki.archlinux.org/index.php/Kernel_parameters is a good starting point.
-https://wiki.archlinux.org/index.php/Kernel_parameters is a good starting point
-* Tell kwin to run with EGLStreams.
+It is also possible to pass the parameter via module configuration:
-You should set the environment variable "KWIN_DRM_USE_EGL_STREAMS=1"
+<code>echo options nvidia_drm modeset=1 | sudo tee /etc/modprobe.d/nvidia_drm.conf</code>
-The easiest place is to add a file /etc/profile.d/kwin.sh  with the line
+You need to regenerate the initramfs in case your distribution provides the graphics drivers in initramfs (e.g. <code>sudo update-initramfs -u</code>)
-export KWIN_DRM_USE_EGL_STREAMS=1
-Verify this is working with the command line tool "env" after rebooting.
+=== Login ===
+* Select “Plasma (Wayland)” from your login manager
+* Enjoy your beautiful super-fast accelerated Wayland desktop!
-* Select "Plasma (wayland)" from your login manager
+=== Known Limitations ===
+* Night Color is not applied to the mouse cursor: https://bugs.kde.org/show_bug.cgi?id=479889
-* Enjoy your beautiful super-fast accelerated wayland desktop!
+* Poor performance on external screens on hybrid GPU setups when using NVIDIA GPU as a secondary GPU because it requires CPU copying from the primary GPU to the secondary GPU (see https://invent.kde.org/plasma/kwin/-/merge_requests/1031, https://bugs.kde.org/show_bug.cgi?id=452219)