1

<<TableOfContents: execution failed [list index out of range] (see also the log)>>

Introduction

NVIDIA Optimus is a technology that allows an Intel integrated GPU and discrete NVIDIA GPU to be built into and accessed by a laptop.
With Fedora 25 and later, NVIDIA Optimus devices are automatically detected with GDM/Gnome. They will run with output source and not with offload sync by default.

With Fedora 29 , along NVIDIA driver 435.17+ and xorg-x11-server 1.20.5-9 (add additional patches), it's now possible to have full Optimus support (with offload sync only with glx). Starting with NVIDIA driver 440.26+ render offload works with EGL.

With Fedora 30 and later, the official fedora xorg-x11-server packages has the needed patches, (so there is no need to use the copr repository). Using NVIDIA 440.31+ will advertise full optimus support (GL/EGL) using a stable driver release. It's not needed to use the previous copr repository that can be disabled using: 

dnf config-manager --set-disable copr:copr.fedorainfracloud.org:kwizart:xorg-x11-server_nvidia

This Howto is a subset of the main documentation, please read the NVIDIA Howto first.

Known limitation

Full Optimus Support can be achieved with xorg-x11-server 1.20.5-9 from official fedora packages (for Fedora 30 and later). This package has patches backported that have lander in xorg-x11-server master branch (that will become xorg 1.21).

NVIDIA PRIME Support

On Fedora 30 and later, with NVIDIA driver 440.31+, there is nothing else to be done beyound normal driver installation. But you can opt-in to enable Dynamic Power Management until this is set as the default in the NVIDIA driver. 

sudo -s
dnf update
cat > /etc/modprobe.d/nvidia.conf <<EOF
# Enable DynamicPwerManagement
# http://download.nvidia.com/XFree86/Linux-x86_64/440.31/README/dynamicpowermanagement.html
options nvidia NVreg_DynamicPowerManagement=0x02
EOF

PRIME Render Offload

As documented at http://download.nvidia.com/XFree86/Linux-x86_64/440.31/README/primerenderoffload.html

Configure Graphics Applications to Render Using the GPU Screen

To configure a graphics application to be offloaded to the NVIDIA GPU screen, set the environment variable NV_PRIME_RENDER_OFFLOAD to 1. If the graphics application uses Vulkan, that should be all that is needed. If the graphics application uses GLX, then also set the environment variable GLX_VENDOR_LIBRARY_NAME to nvidia, so that GLVND loads the NVIDIA GLX driver. NVIDIA's EGL implementation does not yet support PRIME render offload.

Examples: 

__NV_PRIME_RENDER_OFFLOAD=1 vkcube
__NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia glxinfo | grep vendor

Finer-Grained Control of Vulkan

The NV_PRIME_RENDER_OFFLOAD environment variable causes the special Vulkan layer VK_LAYER_NV_optimus to be loaded. Vulkan applications use the Vulkan API to enumerate the GPUs in the system and select which GPU to use; most Vulkan applications will use the first GPU reported by Vulkan. The VK_LAYER_NV_optimus layer causes the GPUs to be sorted such that the NVIDIA GPUs are enumerated first. For finer-grained control, the VK_LAYER_NV_optimus layer looks at the VK_LAYER_NV_optimus environment variable. The value NVIDIA_only causes VK_LAYER_NV_optimus to only report NVIDIA GPUs to the Vulkan application. The value non_NVIDIA_only causes VK_LAYER_NV_optimus to only report non-NVIDIA GPUs to the Vulkan application.

Examples: 

__NV_PRIME_RENDER_OFFLOAD=1 __VK_LAYER_NV_optimus=NVIDIA_only vkcube
__NV_PRIME_RENDER_OFFLOAD=1 __VK_LAYER_NV_optimus=non_NVIDIA_only vkcube

Finer-Grained Control of GLX + OpenGL

For GLX + OpenGL, the environment variable NV_PRIME_RENDER_OFFLOAD_PROVIDER provides finer-grained control. While NV_PRIME_RENDER_OFFLOAD=1 tells GLX to use the first NVIDIA GPU screen, NV_PRIME_RENDER_OFFLOAD_PROVIDER can use an RandR provider name to pick a specific NVIDIA GPU screen, using the NVIDIA GPU screen names reported by xrandr --listproviders.

Examples: 

__NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia glxgears
__NV_PRIME_RENDER_OFFLOAD_PROVIDER=NVIDIA-G0 __GLX_VENDOR_LIBRARY_NAME=nvidia glxgears

External Monitors detection

At this time, external monitors connected to the NVIDIA GPU requires the PrimaryGPU option to be set. See the next topic about how to setup as appropriate.

NVIDIA PrimaryGPU Support

Using PrimaryGPU allows to use the NVIDIA driver by default instead of the iGPU. This is also required in order to use external display when internally connected from the NVIDIA hardware. Unfortunately, setting this option automatically when an external display is connected is not supported by NVIDIA at this time. To recover this previous behaviour, you can use: 

cp -p /usr/share/X11/xorg.conf.d/nvidia.conf /etc/X11/xorg.conf.d/nvidia.conf

And edit the file to use: Option "PrimaryGPU" "yes"

/!\ SSDM and lightdm display manager users: Please Have a look at the ArchLinux wiki about configuring display manager. In Fedora, Gnome users don't need this change.

PRIME Synchronization

With Xorg server 1.19 (Fedora 25 and later), this feature allows buffer sharing between the Intel and the NVIDIA card when using Xorg (not relevant for Wayland). It should be enabled bytThen you can enable Prime Synchronisation for your session: 

xrandr --output <output> --set "PRIME Synchronization" 1

Proprietary/FLOSS switch

At this time, this can be done by manually editing "rd.driver.blacklist=nouveau modprobe.blacklist=nouveau nvidia-drm.modeset=1" from the grub2 cmdline. And replace by "rd.driver.blacklist=nvidia,nvidia_drm,nvidia_modeset modprobe.blacklist=nvidia,nvidia_drm,nvidia_modeset" The plan is to have a grub2 menu to have the choice. Please see Bugzilla [RFE] Switcher for Xorg nvidia/FOSS config

FAQ

References

CategoryHowto