r0chd.pl / sessiond
modular session management daemon
Star
Fork 1
Watch
sessiond docs CONFIGURATION.md
2.7 kB
Markdown
at feat/multi-client-seat

Configuration #

sessiond reads TOML configuration from /etc/sessiond.toml by default. Use sessiond --config <path> to load a different file.

Example #

default-seat = "custom-seat"

[management]
user = "root"
group = "root"

[seats.custom-seat]
user = "root"
group = "seat"
kind = "vt-bound"

[users.alice]
linger = true
runtime-dir = "/run/user/{uid}"

[users.alice.env]
DBUS_SESSION_BUS_ADDRESS = "unix:path={runtime-dir}/bus"

[power]
reboot = ["/run/current-system/sw/bin/reboot"]
poweroff = ["/run/current-system/sw/bin/poweroff"]
suspend = ["/run/current-system/sw/bin/zzz", "-z"]
hibernate = ["/run/current-system/sw/bin/zzz", "-Z"]

Top-level Fields #

  • default-seat: name of the seat created on startup. Defaults to seat0. It must match an entry in seats.
  • management: access rules for session management operations. Defaults to root:root.
  • seats: configured seats. Defaults to a single seat0. (Currently sessiond only supports single seat setups)
  • users: per-user session defaults, keyed by user name.
  • power: commands used by sessionctl reboot, sessionctl poweroff, sessionctl suspend, and sessionctl hibernate.

Unknown fields are rejected.

Seats #

Each seat has these fields:

  • user: user allowed to acquire seat devices. Defaults to root.
  • group: group allowed to acquire seat devices. Defaults to root.
  • kind: either vt-bound or non-vt. Defaults to vt-bound.

A vt-bound seat tracks the active virtual terminal. A non-vt seat is not bound to VT switching.

Management Access #

management.user and management.group grant privileged session management access. Management access can modify users and seats and can run power commands even when other users have active sessions.

Both fields default to root.

Users #

User entries are keyed by login name:

[users.alice]
linger = true
runtime-dir = "/run/user/{uid}"

[users.alice.env]
DBUS_SESSION_BUS_ADDRESS = "unix:path={runtime-dir}/bus"

Supported fields:

  • linger: create the user state and runtime directory when sessiond starts, before the user has an active session. Defaults to false.
  • runtime-dir: runtime directory template. Defaults to /run/user/{uid}.
  • env: extra environment variables sent to newly created sessions.

Values in runtime-dir and env may use these placeholders:

  • {uid}: numeric user ID.
  • {runtime-dir}: the resolved runtime directory. This placeholder is only expanded in env values.

Power Commands #

Power command fields are arrays where the first element is the program and the remaining elements are arguments:

[power]
suspend = ["/run/current-system/sw/bin/loginctl", "suspend"]