FAQ: Mention how to escape from a dead screen locker

1 files changed, 15 insertions, 0 deletions

diff --git a/docs/wiki/FAQ.md b/docs/wiki/FAQ.md
index 9134fc7c..e8235566 100644
--- a/docs/wiki/FAQ.md
+++ b/docs/wiki/FAQ.md
@@ -109,3 +109,18 @@ To fix this, you can:
 
 - Use `focus-follows-mouse max-scroll-amount="0%"`, which will prevent `focus-follows-mouse` from triggering when it would cause scrolling.
 - Set `prefer-no-csd` which will generally cause clients to remove those resizing margins.
+
+### How do I recover from a dead screen locker / from a red screen?
+
+When your screen locker dies, you will be left with a red screen.
+This is niri's locked session background.
+
+You can recover from this by spawning a new screen locker.
+One way is to switch to a different TTY (with a shortcut like <kbd>Ctrl</kbd><kbd>Alt</kbd><kbd>F3</kbd>) and spawning a screen locker to niri's Wayland display, e.g. `WAYLAND_DISPLAY=wayland-1 swaylock`.
+
+Another way is to set `allow-when-locked=true` on your screen locker bind, then you can press it on the red screen to get a fresh screen locker.
+```kdl
+binds {
+    Super+Alt+L allow-when-locked=true { spawn "swaylock"; }
+}
+```