Skip to content

Commit a99b31e

Browse files
committed
config/graphical-session/wayland: explain running SDDM on wayland
1 parent 037e4d3 commit a99b31e

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed

src/config/graphical-session/wayland.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,40 @@ accessing input devices. In Void systems, this requires a seat manager service,
4545
which can be either elogind or seatd. Enabling them is explained in the
4646
["Session and Seat Management"](../session-management.md) session.
4747

48+
### Display Managers
49+
50+
#### SDDM
51+
52+
To run SDDM itself under wayland, create the file
53+
`/etc/sddm.conf.d/10-wayland.conf` (see
54+
[sddm.conf(5)](https://man.voidlinux.org/sddm.conf.5)), with the contents:
55+
56+
```
57+
[General]
58+
DisplayServer=wayland
59+
```
60+
61+
The above configuration requires installing the `weston` compositor.
62+
63+
Alternatively, if SDDM is being used as part of a KDE installation, it may be
64+
preferable to use the `kwin` compositor:
65+
66+
```
67+
[General]
68+
DisplayServer=wayland
69+
GreeterEnvironment=QT_WAYLAND_SHELL_INTEGRATION=layer-shell
70+
71+
[Wayland]
72+
CompositorCommand=kwin_wayland --drm --no-lockscreen --no-global-shortcuts --locale1
73+
```
74+
75+
In either case, to avoid a conflict, disable `agetty` on the first virtual
76+
terminal:
77+
78+
```
79+
touch /etv/sv/agetty-tty1/down
80+
```
81+
4882
### Native applications
4983

5084
[Qt5](https://wayland.freedesktop.org/qt5.html)-based applications require

0 commit comments

Comments
 (0)