## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
## page was renamed from Howto/NVIDIA_Optimus
## page was renamed from Howto/nVidia_Optimus
##master-page:Unknown-Page
##master-date:Unknown-Date
#acl -All:write Default
#format wiki
#language en
<<TableOfContents(5)>>
== 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. <<BR>>
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 [[Howto/NVIDIA|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 [[https://wiki.archlinux.org/index.php/NVIDIA_Optimus#Display_managers|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 [[https://bugzilla.rpmfusion.org/show_bug.cgi?id=4315|Bugzilla [RFE] Switcher for Xorg nvidia/FOSS config]]


== FAQ ==
 *Q: Why there is no nvidia-prime package ? 
 *A: nvidia-prime is not something from NVIDIA despite the name. It's a collection of integration scripts made by canonical for Ubuntu. Better to avoid using custom scripts and to have the driver to setup appropriately if on Optimus hardware or single GPU setup. With Fedora 25 and later, everything is automatically setup.

== References ==
 * http://download.nvidia.com/XFree86/Linux-x86_64/435.17/README/primerenderoffload.html
 * http://download.nvidia.com/XFree86/Linux-x86_64/435.17/README/dynamicpowermanagement.html
 * https://devtalk.nvidia.com/default/topic/957814/linux/prime-and-prime-synchronization/
 * https://devtalk.nvidia.com/default/topic/925605/linux/nvidia-364-12-release-vulkan-glvnd-drm-kms-and-eglstreams/

----
CategoryHowto