NVIDIA - Revision history

Mirin: Undo revision 31777 by Mirin (talk)

2026-05-14T10:51:35Z

Undo revision 31777 by Mirin (talk)

Show changes

Mirin: Prepared the page for translation

2026-05-14T10:29:19Z

Prepared the page for translation

Show changes

Sandro: Drop legacy note

2026-04-28T01:32:52Z

Drop legacy note

← Older revision		Revision as of 01:32, 28 April 2026
Line 7:		Line 7:

	To enable them, add <code>"nvidia"</code> to the list of enabled video drivers defined by the <code>services.xserver.videoDrivers</code> option.		To enable them, add <code>"nvidia"</code> to the list of enabled video drivers defined by the <code>services.xserver.videoDrivers</code> option.

	~~{{Note\|<code>hardware.graphics.enable</code> was named <code>hardware.opengl.enable</code> '''until NixOS 24.11'''.}}~~

	{{Note\|Since driver version 560, you also will need to decide whether to use the open-source or proprietary modules by setting the <code>hardware.nvidia.open</code> option to either <code>true</code> or <code>false</code> respectively.<br><br>Open-source kernel modules are preferred over and planned to steadily replace proprietary modules<ref>https://developer.nvidia.com/blog/nvidia-transitions-fully-towards-open-source-gpu-kernel-modules/</ref>, although they only support GPUs of the Turing architecture or newer (from GeForce RTX 20 series and GeForce GTX 16 series onwards). Data center GPUs starting from Grace Hopper or Blackwell must use open-source modules — proprietary modules are no longer supported.<br><br>Make sure to allow [[Unfree software\|unfree software]] even when using the open module as the user space part of the driver is still proprietary. Other unfree NVIDIA packages include <code>nvidia-x11</code>, <code>nvidia-settings</code>, and <code>nvidia-persistenced</code>.		{{Note\|Since driver version 560, you also will need to decide whether to use the open-source or proprietary modules by setting the <code>hardware.nvidia.open</code> option to either <code>true</code> or <code>false</code> respectively.<br><br>Open-source kernel modules are preferred over and planned to steadily replace proprietary modules<ref>https://developer.nvidia.com/blog/nvidia-transitions-fully-towards-open-source-gpu-kernel-modules/</ref>, although they only support GPUs of the Turing architecture or newer (from GeForce RTX 20 series and GeForce GTX 16 series onwards). Data center GPUs starting from Grace Hopper or Blackwell must use open-source modules — proprietary modules are no longer supported.<br><br>Make sure to allow [[Unfree software\|unfree software]] even when using the open module as the user space part of the driver is still proprietary. Other unfree NVIDIA packages include <code>nvidia-x11</code>, <code>nvidia-settings</code>, and <code>nvidia-persistenced</code>.

LucasFA: /* Multiple boot configurations */ Add reference to the nixos-hardware batterySaver specialisation

2026-03-21T22:17:09Z

Multiple boot configurations: Add reference to the nixos-hardware batterySaver specialisation

← Older revision		Revision as of 22:17, 21 March 2026
Line 203:		Line 203:
	After rebuilding and rebooting, you'll see in your boot menu under each Generation an "on-the-go" option, which will let you boot into the on-to-go specialisation for that generation.		After rebuilding and rebooting, you'll see in your boot menu under each Generation an "on-the-go" option, which will let you boot into the on-to-go specialisation for that generation.

			See also the [https://github.com/NixOS/nixos-hardware/blob/master/common/gpu/nvidia/prime.nix nixos-hardware] implementation of a similar idea.
	=== Using GPUs on non-NixOS ===		=== Using GPUs on non-NixOS ===
	If you're using Nix-packaged software on a non-NixOS system, you'll need a workaround to get everything up-and-running. The [https://github.com/guibou/nixGL nixGL project] provides wrapper to use GL drivers on non-NixOS systems. You need to have GPU drivers installed on your distro (for kernel modules). With nixGL installed, you'll run <code>nixGL foobar</code> instead of <code>foobar</code>.		If you're using Nix-packaged software on a non-NixOS system, you'll need a workaround to get everything up-and-running. The [https://github.com/guibou/nixGL nixGL project] provides wrapper to use GL drivers on non-NixOS systems. You need to have GPU drivers installed on your distro (for kernel modules). With nixGL installed, you'll run <code>nixGL foobar</code> instead of <code>foobar</code>.

MaxWolf-01: Add MPS section: systemd service config + Docker usage, document silent PATH failure

2026-03-06T05:33:11Z

Add MPS section: systemd service config + Docker usage, document silent PATH failure

@@ Line 210: / Line 210: @@
 === CUDA and using your GPU for compute ===
 See the [[CUDA]] wiki page.
 === Running Specific NVIDIA Driver Versions ===

Focusgraph at 20:09, 4 February 2026

2026-02-04T20:09:50Z

← Older revision		Revision as of 20:09, 4 February 2026
Line 10:		Line 10:
	{{Note\|<code>hardware.graphics.enable</code> was named <code>hardware.opengl.enable</code> '''until NixOS 24.11'''.}}		{{Note\|<code>hardware.graphics.enable</code> was named <code>hardware.opengl.enable</code> '''until NixOS 24.11'''.}}

	{{Note\|Since driver version 560, you also will need to decide whether to use the open-source or proprietary modules by setting the <code>hardware.nvidia.open</code> option to either <code>true</code> or <code>false</code> respectively.<br><br>Open-source kernel modules are preferred over and planned to steadily replace proprietary modules<ref>https://developer.nvidia.com/blog/nvidia-transitions-fully-towards-open-source-gpu-kernel-modules/</ref>, although they only support GPUs of the Turing architecture or newer (from GeForce RTX 20 series and GeForce GTX 16 series onwards). Data center GPUs starting from Grace Hopper or ~~Blackwall~~ must use open-source modules — proprietary modules are no longer supported.<br><br>Make sure to allow [[Unfree software\|unfree software]] even when using the open module as the user space part of the driver is still proprietary. Other unfree NVIDIA packages include <code>nvidia-x11</code>, <code>nvidia-settings</code>, and <code>nvidia-persistenced</code>.		{{Note\|Since driver version 560, you also will need to decide whether to use the open-source or proprietary modules by setting the <code>hardware.nvidia.open</code> option to either <code>true</code> or <code>false</code> respectively.<br><br>Open-source kernel modules are preferred over and planned to steadily replace proprietary modules<ref>https://developer.nvidia.com/blog/nvidia-transitions-fully-towards-open-source-gpu-kernel-modules/</ref>, although they only support GPUs of the Turing architecture or newer (from GeForce RTX 20 series and GeForce GTX 16 series onwards). Data center GPUs starting from Grace Hopper or Blackwell must use open-source modules — proprietary modules are no longer supported.<br><br>Make sure to allow [[Unfree software\|unfree software]] even when using the open module as the user space part of the driver is still proprietary. Other unfree NVIDIA packages include <code>nvidia-x11</code>, <code>nvidia-settings</code>, and <code>nvidia-persistenced</code>.
	}}{{Warning\|If you use a laptop with both dedicated and integrated GPUs, remember to [[#Hybrid_graphics_with_PRIME\|configure PRIME]] in order to make your dedicated NVIDIA GPU work properly with your integrated GPU. Your configuration '''might not work''' if you skip this step.}}{{file\|configuration.nix\|nix\|<nowiki>		}}{{Warning\|If you use a laptop with both dedicated and integrated GPUs, remember to [[#Hybrid_graphics_with_PRIME\|configure PRIME]] in order to make your dedicated NVIDIA GPU work properly with your integrated GPU. Your configuration '''might not work''' if you skip this step.}}{{file\|configuration.nix\|nix\|<nowiki>
	{		{

Player131007: Use the new BusId format in nixpkgs

2026-01-16T14:39:35Z

Use the new BusId format in nixpkgs

← Older revision		Revision as of 14:39, 16 January 2026
Line 66:		Line 66:
	0000:00:02.0 VGA compatible controller: Intel Corporation TigerLake-H GT1 [UHD Graphics] (rev 01)		0000:00:02.0 VGA compatible controller: Intel Corporation TigerLake-H GT1 [UHD Graphics] (rev 01)
	0000:01:00.0 VGA compatible controller: NVIDIA Corporation GA106M [GeForce RTX 3060 Mobile / Max-Q] (rev a1)		0000:01:00.0 VGA compatible controller: NVIDIA Corporation GA106M [GeForce RTX 3060 Mobile / Max-Q] (rev a1)
	</syntaxhighlight>Before putting them into your configuration, however, '''they must first be reformatted''' — ~~take~~ the ~~last three numbers~~, convert ~~them~~ from hexadecimal to decimal, ~~remove~~ the ~~leading zeroes, concatenate them with colons, and then add a~~ <code>PCI:</code> ~~prefix~~. ~~Then, they~~ can be set under <code>intelBusId</code>, <code>nvidiaBusId</code>, or <code>amdgpuBusId</code> in <code>hardware.nvidia.prime</code>, depending on the manufacturer of the GPU:{{file\|configuration.nix\|nix\|<nowiki>		</syntaxhighlight>Before putting them into your configuration, however, '''they must first be reformatted''' — assuming the bus address is <code><domain>:<bus>:<device>.<func></code>, convert all numbers from hexadecimal to decimal, then the formatted string is <code>PCI:<bus>@<domain>:<device>:<func></code>. They can be set under <code>intelBusId</code>, <code>nvidiaBusId</code>, or <code>amdgpuBusId</code> in <code>hardware.nvidia.prime</code>, depending on the manufacturer of the GPU:{{file\|configuration.nix\|nix\|<nowiki>
	{		{
	hardware.nvidia.prime = {		hardware.nvidia.prime = {
	intelBusId = "PCI:0:2:0";		intelBusId = "PCI:0@0:2:0";
	nvidiaBusId = "PCI:1:0:0";		nvidiaBusId = "PCI:1@0:0:0";
	#amdgpuBusId = "PCI:54:0:0"; # If you have an AMD iGPU		# amdgpuBusId = "PCI:5@0:0:0"; # If you have an AMD iGPU
	};		};
	}		}
Line 95:		Line 95:
	offload.enable = true;		offload.enable = true;

	intelBusId = "PCI:0:2:0";		intelBusId = "PCI:0@0:2:0";
	nvidiaBusId = "PCI:1:0:0";		nvidiaBusId = "PCI:1@0:0:0";
	#amdgpuBusId = "PCI:54:0:0"; # If you have an AMD iGPU		# amdgpuBusId = "PCI:5@0:0:0"; # If you have an AMD iGPU
	};		};
	}		}
Line 118:		Line 118:
	sync.enable = true;		sync.enable = true;

	intelBusId = "PCI:0:2:0";		intelBusId = "PCI:0@0:2:0";
	nvidiaBusId = "PCI:1:0:0";		nvidiaBusId = "PCI:1@0:0:0";
	#amdgpuBusId = "PCI:54:0:0"; # If you have an AMD iGPU		# amdgpuBusId = "PCI:5@0:0:0"; # If you have an AMD iGPU
	};		};
	}		}
Line 135:		Line 135:
	reverseSync.enable = true;		reverseSync.enable = true;

	intelBusId = "PCI:0:2:0";		intelBusId = "PCI:0@0:2:0";
	nvidiaBusId = "PCI:1:0:0";		nvidiaBusId = "PCI:1@0:0:0";
	#amdgpuBusId = "PCI:54:0:0"; # If you have an AMD iGPU		# amdgpuBusId = "PCI:5@0:0:0"; # If you have an AMD iGPU
	};		};
	}		}

Player131007: Make lspci command also show the domain, even if it's 0

2026-01-16T14:23:18Z

Make lspci command also show the domain, even if it's 0

← Older revision		Revision as of 14:23, 16 January 2026
Line 63:		Line 63:
	==== Common setup ====		==== Common setup ====
	All PRIME configurations require setting the PCI bus IDs of the two GPUs. One easy way to do find their IDs is by running <code>lspci</code> from the <code>pciutils</code> package, and then finding devices that are classified as VGA controllers. After double checking that the listed devices are indeed your integrated and dedicated GPUs, you can then find the PCI IDs at the beginning of each line. Exact results may vary, but an example output might look like:<syntaxhighlight lang="console">		All PRIME configurations require setting the PCI bus IDs of the two GPUs. One easy way to do find their IDs is by running <code>lspci</code> from the <code>pciutils</code> package, and then finding devices that are classified as VGA controllers. After double checking that the listed devices are indeed your integrated and dedicated GPUs, you can then find the PCI IDs at the beginning of each line. Exact results may vary, but an example output might look like:<syntaxhighlight lang="console">
	$ nix shell nixpkgs#pciutils -c lspci -d ::03xx		$ nix shell nixpkgs#pciutils -c lspci -D -d ::03xx
	0000:00:02.0 VGA compatible controller: Intel Corporation TigerLake-H GT1 [UHD Graphics] (rev 01)		0000:00:02.0 VGA compatible controller: Intel Corporation TigerLake-H GT1 [UHD Graphics] (rev 01)
	0000:01:00.0 VGA compatible controller: NVIDIA Corporation GA106M [GeForce RTX 3060 Mobile / Max-Q] (rev a1)		0000:01:00.0 VGA compatible controller: NVIDIA Corporation GA106M [GeForce RTX 3060 Mobile / Max-Q] (rev a1)

Atix: change sub sections to heading 2 , it was a cheeky little mistake

2025-12-18T15:47:43Z

change sub sections to heading 2 , it was a cheeky little mistake

← Older revision		Revision as of 15:47, 18 December 2025
Line 152:		Line 152:
	</nowiki>}}		</nowiki>}}

	=== Supported Compositors ===		==== Supported Compositors ====

	* '''GNOME (Wayland)'''		* '''GNOME (Wayland)'''

Line 166:		Line 165:
	Generally works with recent NVIDIA drivers, but support is not officially guaranteed. Regressions may occur after driver or compositor updates.		Generally works with recent NVIDIA drivers, but support is not officially guaranteed. Regressions may occur after driver or compositor updates.

	=== PRIME and Wayland ===		==== PRIME and Wayland ====

	* PRIME '''sync''' and '''reverse sync''' modes are '''X11-only''' and do not work under Wayland.		* PRIME '''sync''' and '''reverse sync''' modes are '''X11-only''' and do not work under Wayland.
	* PRIME '''offload''' works under Wayland, but application offloading may behave differently depending on the compositor.		* PRIME '''offload''' works under Wayland, but application offloading may behave differently depending on the compositor.

	=== Explict Sync ===		==== Explict Sync ====
	Drivers ≥ 555 introduce explicit sync support, which greatly improves frame pacing and reduces flickering and stuttering under Wayland. For the best Wayland experience, recent NVIDIA drivers are strongly recommended.		Drivers ≥ 555 introduce explicit sync support, which greatly improves frame pacing and reduces flickering and stuttering under Wayland. For the best Wayland experience, recent NVIDIA drivers are strongly recommended.

Atix: added a Wayland section for Wayland specific stuff

2025-12-18T15:43:22Z

added a Wayland section for Wayland specific stuff

@@ Line 141: / Line 141: @@
+}
 </nowiki>}}
 == Tips and tricks ==

← Older revision		Revision as of 20:09, 4 February 2026
Line 10:		Line 10:
	{{Note\|<code>hardware.graphics.enable</code> was named <code>hardware.opengl.enable</code> '''until NixOS 24.11'''.}}		{{Note\|<code>hardware.graphics.enable</code> was named <code>hardware.opengl.enable</code> '''until NixOS 24.11'''.}}

	{{Note\|Since driver version 560, you also will need to decide whether to use the open-source or proprietary modules by setting the <code>hardware.nvidia.open</code> option to either <code>true</code> or <code>false</code> respectively.<br><br>Open-source kernel modules are preferred over and planned to steadily replace proprietary modules<ref>https://developer.nvidia.com/blog/nvidia-transitions-fully-towards-open-source-gpu-kernel-modules/</ref>, although they only support GPUs of the Turing architecture or newer (from GeForce RTX 20 series and GeForce GTX 16 series onwards). Data center GPUs starting from Grace Hopper or ~~Blackwall~~ must use open-source modules — proprietary modules are no longer supported.<br><br>Make sure to allow [[Unfree software\|unfree software]] even when using the open module as the user space part of the driver is still proprietary. Other unfree NVIDIA packages include <code>nvidia-x11</code>, <code>nvidia-settings</code>, and <code>nvidia-persistenced</code>.		{{Note\|Since driver version 560, you also will need to decide whether to use the open-source or proprietary modules by setting the <code>hardware.nvidia.open</code> option to either <code>true</code> or <code>false</code> respectively.<br><br>Open-source kernel modules are preferred over and planned to steadily replace proprietary modules<ref>https://developer.nvidia.com/blog/nvidia-transitions-fully-towards-open-source-gpu-kernel-modules/</ref>, although they only support GPUs of the Turing architecture or newer (from GeForce RTX 20 series and GeForce GTX 16 series onwards). Data center GPUs starting from Grace Hopper or Blackwell must use open-source modules — proprietary modules are no longer supported.<br><br>Make sure to allow [[Unfree software\|unfree software]] even when using the open module as the user space part of the driver is still proprietary. Other unfree NVIDIA packages include <code>nvidia-x11</code>, <code>nvidia-settings</code>, and <code>nvidia-persistenced</code>.
	}}{{Warning\|If you use a laptop with both dedicated and integrated GPUs, remember to [[#Hybrid_graphics_with_PRIME\|configure PRIME]] in order to make your dedicated NVIDIA GPU work properly with your integrated GPU. Your configuration '''might not work''' if you skip this step.}}{{file\|configuration.nix\|nix\|<nowiki>		}}{{Warning\|If you use a laptop with both dedicated and integrated GPUs, remember to [[#Hybrid_graphics_with_PRIME\|configure PRIME]] in order to make your dedicated NVIDIA GPU work properly with your integrated GPU. Your configuration '''might not work''' if you skip this step.}}{{file\|configuration.nix\|nix\|<nowiki>
	{		{