Seatd: Difference between revisions

From Alpine Linux
(simplified the script to launch sway on tty1 by removing references to $XDG_VTNR and removed headings)
(moved XDG_RUNTIME_DIR to Prerequisites section)
 
(21 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Seatd is a seat management daemon, that does everything it needs to do. Nothing more, nothing less. Depends only on libc. Seat management takes care of mediating access to shared devices (graphics, input), without requiring the applications needing access to be root.
{{Verified|0}}[https://man.sr.ht/~kennylevinsen/seatd/ Seatd] is a [[Seat manager|seat management]] daemon, that does everything it needs to do. Nothing more, nothing less. Depends only on libc. Seat management takes care of mediating access to shared devices (graphics, input), without requiring the applications needing access to be root.


When using [[elogind]], seatd is not required and viceversa. Don't add both to auto-start.
When using [[elogind]], seatd is not required and viceversa. Don't add both to auto-start.
== Prerequisites ==
* Seatd requires that [[XDG_RUNTIME_DIR]] is set before starting your [[Wayland]] compositor.


== Installation ==
== Installation ==


{{Cmd|apk add {{Pkg|seatd}}       # install seatd
Install the {{Pkg|seatd}} package:{{Cmd|# apk add {{Pkg|seatd}}}}
rc-update add seatd # configure it to auto-start
 
service seatd start # start it now
== Configuration ==
adduser $USER seat  # allow current user to access seatd
}}


If you are already logged in as a <code>$USER</code>, you will need to relogin.
=== Service management ===
To add the {{ic|seatd}} service to auto-start using [[OpenRC]]: {{Cmd|<nowiki># rc-update add seatd
# rc-service seatd start </nowiki>}}


== Configuration ==
To add the currently logged in user to {{ic|seat}} group issue the command: {{Cmd|$ doas adduser $USER seat}}


Seatd is the light weight solution for [[Wayland]] compositors compared to [[elogind]]. However, when using seatd ensure that the following two mandatory steps are completed.
If you are already logged in as a <code>$USER</code>, you will need to relogin.


* Set the variable [[XDG_RUNTIME_DIR]].
=== Polkit ===
* The following environment variables needs to be set:
<code>XDG_SESSION_TYPE=wayland</code>
<code>LIBSEAT_BACKEND=seatd</code>
<code>XDG_CURRENT_DESKTOP=sway</code>


The variable <code>XDG_CURRENT_DESKTOP</code> must be suitably adjusted if a different [[:Category:Compositor|Compositor]] is used.
[[Polkit#Using polkit with seatd|Polkit]] can be configured and used for authentication with seatd with certain limitations. Since seatd doesn't provide detailed session tracking, polkit rules that rely on these properties (e.g., subject.active, subject.local) cannot be evaluated. Hence graphical, session-aware [[Polkit#Authentication agents|polkit authentication agents]] are not supported.


== Seatd and sway ==
Refer to [[Polkit#Example1|sample polkit rule file]] that works with seatd.


When using seatd, adding the following lines to {{Path|~/.profile}} or other shell specific profile file will launch Sway automatically with and [[D-Bus]] only in tty1. {{Cat|~/.profile|<nowiki>...
== See also ==
# Set the environment variables required for seatd
export XDG_SESSION_TYPE=wayland
export LIBSEAT_BACKEND=seatd
export XDG_CURRENT_DESKTOP=sway
#start sway with DBUS (only in tty1)
if [ "$(tty)" = "/dev/tty1" ]; then
    exec dbus-run-session sway
fi
...</nowiki>}}
Instead of depending on {{Path|.profile}} or their equivalent files a [[Sway#Starting_sway|wrapper script]] can also be used.


== See Also ==
* [https://man.sr.ht/~kennylevinsen/seatd/ seatd documentation]
* [https://man.sr.ht/~kennylevinsen/seatd/ seatd documentation]
* [https://github.com/swaywm/sway/wiki/Setting-environmental-variables sway wiki]
* [https://github.com/swaywm/sway/wiki/Setting-environmental-variables sway wiki]


[[Category:Desktop]]
[[Category:Seat_manager]]
[[Category:Seat_manager]]
[[Category:Wayland]]

Latest revision as of 12:15, 16 August 2025

Seatd is a seat management daemon, that does everything it needs to do. Nothing more, nothing less. Depends only on libc. Seat management takes care of mediating access to shared devices (graphics, input), without requiring the applications needing access to be root.

When using elogind, seatd is not required and viceversa. Don't add both to auto-start.

Prerequisites

Installation

Install the seatd package:

# apk add seatd

Configuration

Service management

To add the seatd service to auto-start using OpenRC:

# rc-update add seatd # rc-service seatd start

To add the currently logged in user to seat group issue the command:

$ doas adduser $USER seat

If you are already logged in as a $USER, you will need to relogin.

Polkit

Polkit can be configured and used for authentication with seatd with certain limitations. Since seatd doesn't provide detailed session tracking, polkit rules that rely on these properties (e.g., subject.active, subject.local) cannot be evaluated. Hence graphical, session-aware polkit authentication agents are not supported.

Refer to sample polkit rule file that works with seatd.

See also