Hyprland Wiki
Contribute to the Wiki!Toggle Dark/Light/Auto modeToggle Dark/Light/Auto modeToggle Dark/Light/Auto modeBack to homepage



There is no official support for Nvidia. Unfortunately, their drivers are so messy, and their products so random, that it’s impossible for us to help if these instructions don’t work fully.

Every card seems to be random, and might work perfectly, or not work at all.

Nevertheless, it’s recommended to at least try this tutorial.

How to get Hyprland to possibly work on Nvidia

Install the nvidia-dkms driver and add it to your initramfs & kernel parameters. Follow the information available here: https://wiki.archlinux.org/title/NVIDIA#DRM_kernel_mode_setting

in /etc/mkinitcpio.conf add nvidia nvidia_modeset nvidia_uvm nvidia_drm to your MODULES

run # mkinitcpio --config /etc/mkinitcpio.conf --generate /boot/initramfs-custom.img

add a new line to /etc/modprobe.d/nvidia.conf (make it if it does not exist) and add the line options nvidia-drm modeset=1

If your GPU is listed as supported by the nvidia-open-dkms driver, use that one instead.

Following the wrapping instructions found on the Quick Start page, wrap the launcher and additionally export these:

export LIBVA_DRIVER_NAME=nvidia
export XDG_SESSION_TYPE=wayland
export GBM_BACKEND=nvidia-drm

Install qt5-wayland, qt5ct and libva. Additionally nvidia-vaapi-driver-git (AUR) to fix crashes in some Electron-based applications, such as Unity Hub.

Reboot your computer

Launch Hyprland with the wrapper.

It should work now.

Fixing random flickering, method 1

If you take a look at the wlroots patches in the nix flake you will find a one-line patch:

substituteInPlace render/gles2/renderer.c --replace "glFlush();" "glFinish();"

What this means, for non-nix users, is you have to (before building) go to subprojects/wlroots/render/gles2/renderer.c and replace all occurrences of glFlush() with glFinish(), and then compile Hyprland as usual.

Fixing random flickering, method 2 (nuclear)

Do note though that this forces performance mode to be active, resulting in increased power-consumption (from 22W idle on a RTX 3070TI, to 74W).

This may not even be needed for some users, only apply these ‘fixes’ if you in-fact do notice flickering artifacts from being idle for ~5 seconds.

Make a new file at /etc/modprobe.d/nvidia.conf and paste this in:

options nvidia NVreg_RegistryDwords="PowerMizerEnable=0x1; PerfLevelSrc=0x2222; PowerMizerLevel=0x3; PowerMizerDefault=0x3; PowerMizerDefaultAC=0x3"

Reboot your computer and it should be working.