greetd(1)

1greetd(1)                   General Commands Manual                  greetd(1)
2
3
4

NAME

6       greetd - A login manager daemon
7

SYNOPSIS

9       greetd [options]
10

OPTIONS

12       -h, --help
13           Show help message and quit.
14
15       -c, --config <config>
16           Specifies the configuration file to use.
17

DESCRIPTION

19       greetd was created to fill the need for a simple login manager that
20       makes no assumptions about the applications it starts, thus being
21       equally suitable for starting console sessions, Wayland sessions, or
22       something else entirely.
23
24       greetd does not itself interact with the user, but relies on an exter‐
25       nal greeter process like agreety(1) to handle that aspect.
26

OPERATION

28       greetd operates on sessions. A greeter creates a session, attempts to
29       authenticate a user in it, and finally, uses it start an arbitrary ap‐
30       plication.
31
32       There are two types of preconfigured sessions: The default session,
33       also known as the greeter, and the optional initial session, serving
34       the purpose of "auto-login". The initial session, if configured, is
35       started once when greetd launches. The default session is started on
36       launch if an initial session is not configured, and started again when‐
37       ever no session is running, such as when the user logs out.
38
39       An IPC socket is exposed to this greeter, as reported by GREETD_SOCK.
40       The greeter can use this to create, authenticate and finally start a
41       session. For more information about the IPC layer, see greetd-ipc(7).
42
43       Once the greeter has requested the start of a session and terminated
44       itself, greetd will start the new session. Once this session termi‐
45       nates, the process starts over.
46
47       greetd makes no assumptions about any sessions, including the greeter.
48       They can be text-based, running in the active console, or full-on
49       graphical environments.
50

CONFIGURATION

52       greetd looks for a configuration file in /etc/greetd/config.toml by de‐
53       fault. This can be overriden with a command-line argument.
54
55       For information on the config file format, see greetd(5).
56

AUTHORS

58       Maintained by Kenny Levinsen <contact@kl.wtf>. For more information
59       about greetd development, see https://git.sr.ht/~kennylevinsen/greetd.
60