aboutsummaryrefslogtreecommitdiff
path: root/wiki
diff options
context:
space:
mode:
authorIvan Molodetskikh <yalterz@gmail.com>2024-11-08 09:43:43 +0300
committerIvan Molodetskikh <yalterz@gmail.com>2024-11-08 09:43:43 +0300
commitb6f6d6a7c24731fb8f03e797ade7805b76c334c6 (patch)
treed0e4962d84c2ff94dc12d84f19e7a90fa37cfb0a /wiki
parent5ff8b89aafca0143866f93dd7e2f27aee6c2b0f5 (diff)
downloadniri-b6f6d6a7c24731fb8f03e797ade7805b76c334c6.tar.gz
niri-b6f6d6a7c24731fb8f03e797ade7805b76c334c6.tar.bz2
niri-b6f6d6a7c24731fb8f03e797ade7805b76c334c6.zip
wiki: Update getting started
Diffstat (limited to 'wiki')
-rw-r--r--wiki/Getting-Started.md12
1 files changed, 3 insertions, 9 deletions
diff --git a/wiki/Getting-Started.md b/wiki/Getting-Started.md
index 23e80f21..e1a5c19d 100644
--- a/wiki/Getting-Started.md
+++ b/wiki/Getting-Started.md
@@ -10,6 +10,7 @@ To exit niri, press <kbd>Super</kbd><kbd>Shift</kbd><kbd>E</kbd>.
If you're not using a display manager, you should run `niri-session` (systemd/dinit) or `niri --session` (others) from a TTY.
The `--session` flag will make niri import its environment variables globally into the system manager and D-Bus, and start its D-Bus services.
+The `niri-session` script will additionally start niri as a systemd/dinit service, which starts up a graphical session target required by some services like portals.
You can also run `niri` inside an existing desktop session.
Then it will open as a window, where you can give it a try.
@@ -22,21 +23,13 @@ Finally, the [Xwayland](./Xwayland.md) page explains how to run X11 applications
### NVIDIA
-NVIDIA GPUs tend to have problems running niri (for example, the screen remains black upon starting from a TTY).
+NVIDIA GPUs can 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.
-If niri runs but the screen flickers, try adding this into your niri config:
-
-```
-debug {
- wait-for-frame-completion-before-queueing
-}
-```
-
### Asahi, ARM, and other kmsro devices
On some of these systems, niri fails to correctly detect the primary render device.
@@ -69,6 +62,7 @@ If you still get a black screen, try using each of the `card` devices.
### 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.
+When this happens, you usually see a black screen when trying to start niri from a TTY.
Also, on Intel graphics, you may need a workaround described [here](https://nixos.wiki/wiki/Intel_Graphics).