From 1394afaae92686e6dc65d535514b167715533333 Mon Sep 17 00:00:00 2001 From: Ivan Molodetskikh Date: Sat, 4 May 2024 16:25:48 +0400 Subject: wiki: Mention nixos and nvidia issues in getting started --- wiki/Getting-Started.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/wiki/Getting-Started.md b/wiki/Getting-Started.md index 38267e90..28edac12 100644 --- a/wiki/Getting-Started.md +++ b/wiki/Getting-Started.md @@ -20,6 +20,21 @@ Also, check the [configuration overview](./Configuration:-Overview.md) page to g There you can find links to other pages containing thorough documentation and examples for all options. Finally, the [Xwayland](./Xwayland.md) page explains how to run X11 applications on niri. +### NVIDIA + +NVIDIA GPUs tend to have problems running niri (for example, the screen remains black upon starting from a TTY). +Sometimes, the problems can be fixed. +You can try the following: + +1. Update NVIDIA drivers. You need a GPU and drivers recent enough to support GBM. +2. Make sure kernel modesetting is enabled. This usually involves adding `nvidia-drm.modeset=1` to the kernel command line. Find and follow a guide for your distribution. Guides from other Wayland compositors can help. + +### Nix/NixOS + +There's a common problem of mesa drivers going out of sync with niri, so make sure your system mesa version matches the niri mesa version. + +Also, on Intel graphics, you may need a workaround described here: https://nixos.wiki/wiki/Intel_Graphics + ### Virtual Machines To run niri in a VM, make sure to enable 3D acceleration. -- cgit