Skip to content

Commit eebe5d1

Browse files
committed
config/session-management: add turnstile
1 parent 2453a86 commit eebe5d1

File tree

1 file changed

+27
-4
lines changed

1 file changed

+27
-4
lines changed

src/config/session-management.md

Lines changed: 27 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,31 @@ to consider before installing elogind.
3737
To make use of its features, install the `elogind` package and make sure the
3838
[system D-Bus](#d-bus) is enabled. You might need to log out and in again.
3939

40-
If you're having any issues with elogind, [enable](./services/index.md) its
41-
service, as waiting for a D-Bus activation can lead to issues.
40+
If you're having any issues with elogind,
41+
[enable](./services/index.md#enabling-services) its service, as waiting for a
42+
D-Bus activation can lead to issues.
43+
44+
## turnstile
45+
46+
[turnstile](https://github.com/chimera-linux/turnstile) is an alternative
47+
session manager, and can be used with or without [elogind](#elogind).
48+
49+
If using turnstile with elogind, disable rundir (`XDG_RUNTIME_DIR`) management
50+
in `/etc/turnstile/turnstiled.conf` by setting `manage_rundir` to `no`. Note
51+
that while elogind and turnstile currently can coexist, this may change in the
52+
future.
53+
54+
If using turnstile without elogind, consider installing and enabling
55+
[seatd](#seatd) for seat management and [acpid](./power-management.md#acpid) for
56+
power management.
57+
58+
To use it, [enable](./services/index.md#enabling-services) the `turnstiled`
59+
service and re-log in.
60+
61+
Turnstile can also manage [per-user
62+
services](./services/user-services.md#turnstile) (including running a [D-Bus
63+
session bus](#d-bus)), removing the need for wrapping graphical sessions with
64+
`dbus-run-session`.
4265

4366
## seatd
4467

@@ -59,8 +82,8 @@ Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-
5982
Its value sets the path to the base directory where programs should store
6083
user-specific runtime files.
6184

62-
Install [elogind](#elogind) as your session manager to automatically set up
63-
`XDG_RUNTIME_DIR`.
85+
Install [elogind](#elogind) or [turnstile](#turnstile) as your session manager
86+
to automatically set up `XDG_RUNTIME_DIR`.
6487

6588
Alternatively, manually set the environment variable through the shell. Make
6689
sure to create a dedicated user directory and set its permissions to `700`. A

0 commit comments

Comments
 (0)