Skip to content
article

nvidia on wayland in 2026: it mostly works now, and here is the exact config that got me there

arch, sway, a 30-series card, and the five settings that stopped the flicker

Lena Hoffmann@arch_btw_lena

July 8, 2026 · 2 min read

i have complained about nvidia on wayland for years (see my torvalds clip) so it is only fair to say: in 2026 it mostly works. not perfectly. mostly. here is the actual config that took me from "unusable flicker and dead external monitor" to "daily driver", on arch with sway and an nvidia 30-series card. distro: arch, kernel 6.x, sway, nvidia proprietary driver (not nouveau, not yet).

1. the driver and the kernel modules

install the proprietary nvidia driver and, this is the bit people miss, enable the DRM kernel mode setting. add nvidia_drm.modeset=1 to your kernel parameters. without it, wayland compositors and nvidia do not get along and you get the flicker everyone screenshots.

2. early loading

put the nvidia modules in your initramfs (MODULES=(nvidia nvidia_modeset nvidia_uvm nvidia_drm) in mkinitcpio.conf) and rebuild. this stops the "works after i replug the monitor" nonsense because the module is there before the display comes up.

3. launch sway with the right flag

sway historically refused nvidia without --unsupported-gpu. on current versions it is better but if sway will not start on nvidia, that flag is the first thing to try. yes the flag is called that on purpose. yes it is a little insulting. it works.

4. environment variables

the ones that actually mattered for me: WLR_NO_HARDWARE_CURSORS=1 (kills the invisible/laggy cursor), and setting the GBM backend so electron apps and firefox pick the right path. firefox needs MOZ_ENABLE_WAYLAND=1 or it runs under xwayland and looks blurry on a hidpi screen.

5. the external monitor

the dead external monitor on wake was the modeset issue in point 1 ninety percent of the time. the last ten percent was a specific cable, because of course it was. if one output refuses to wake, before you reinstall your whole system, try a different cable and port. i lost an evening to a dock that half worked.

honest verdict

is it as smooth as my friends on amd? no. do games and my daily work run fine now, with the occasional need to restart sway after a driver update? yes. if you are buying a laptop specifically for linux, still buy amd or intel graphics and save yourself the config. but if you already have nvidia, it is no longer a reason to stay on x11 or windows. it mostly works now. i cannot believe i typed that either.

Written by

Lena Hoffmann

i use arch btw. sway, neovim, too many dotfiles. backend dev (go) by day, ricing by night. leipzig. dotfiles on github, PRs welcome, opinions about my font not welcome

Get the best of #linux_desktop_year weekly

One email each Monday with the most useful posts. No spam; unsubscribe in one click.

Comments

5

Sign in to join the conversation.

Sign in to comment
Nguyễn Minh Hiếu@homelab_hieu#3 in Year of the Linux Desktop
the nvidia_drm.modeset=1 is THE one. every single "wayland flicker nvidia" thread is someone who did not set it. i have this bookmarked to paste at people now, saves me very much typing :) also the cable point, i lost a whole weekend to a bad displayport cable last year, never again
2 net votes
Alasdair Reid@onprem_or_die#4 in Year of the Linux Desktop
imagine writing a thousand word guide to make a graphics card display a desktop. i had a sun workstation in 1998 that just showed a picture when ye turned it on. the YAML generation would call that a miracle.
3 net votes
Lena Hoffmann@arch_btw_lena#1 in Year of the Linux Desktop
the sun workstation also cost more than my car and could not run a browser @onprem_or_die. i will take the thousand words. also you are in a wayland thread again, do you just follow me around to be disappointed
2 net votes
Alasdair Reid@onprem_or_die#4 in Year of the Linux Desktop
aye. somebody has to witness it. away and set another environment variable.
2 net votes
Gustavo Lemos@gulemos#6 in Year of the Linux Desktop
rodei isso num container com gpu passthrough e funcionou, valeu. the modeset in initramfs tip fixed my proxmox vm desktop too, same root cause. nvidia is nvidia everywhere.
1 net votes