NVIDIA

Introduction

The NVIDIA module configures the pinned proprietary driver, open or closed kernel modules, suspend support, hardware video acceleration, and optional PRIME render offload.

Requirements

Enable PRIME only on hybrid-graphics hosts and set the integrated and NVIDIA GPU bus IDs from lspci. The selected kernel must remain compatible with the pinned driver version.

Troubleshooting

Use nvidia-smi and journalctl -k to check driver loading. Resume problems are reported by nvidia-suspend.service, nvidia-resume.service, or nvidia-hibernate.service; PRIME failures usually indicate incorrect nvidia.prime.*BusId values or offload settings.

Options

nvidia.enable

Enable proprietary NVIDIA driver support.

Type: boolean

Default:

false

Declared by:

nvidia.bleedingEdge

Use nixpkgs unstable’s bleeding-edge NVIDIA driver instead of its production driver.

Type: boolean

Default:

false

Declared by:

nvidia.open

Use NVIDIA’s open kernel modules.

Type: boolean

Default:

true

Declared by:

nvidia.prime.enable

Enable NVIDIA PRIME for hybrid graphics.

Type: boolean

Default:

false

Declared by:

nvidia.prime.amdgpuBusId

AMD GPU bus ID for NVIDIA PRIME.

Type: string

Default:

""

Example:

"PCI:5:0:0"

Declared by:

nvidia.prime.intelBusId

Intel GPU bus ID for NVIDIA PRIME.

Type: string

Default:

""

Example:

"PCI:0:2:0"

Declared by:

nvidia.prime.nvidiaBusId

NVIDIA GPU bus ID for NVIDIA PRIME.

Type: string

Default:

""

Example:

"PCI:1:0:0"

Declared by:

nvidia.prime.offload.enable

Enable NVIDIA PRIME render offload mode.

Type: boolean

Default:

true

Declared by:

nvidia.prime.offload.enableOffloadCmd

Enable the nvidia-offload command for NVIDIA PRIME render offload.

Type: boolean

Default:

true

Declared by: