sddm.conf(5)

1SDDM.CONF(5)                         sddm                         SDDM.CONF(5)
2
3
4

NAME

6       sddm.conf - sddm display manager configuration
7

SYNOPSIS

9       Configuration loads all files in the configuration directories followed
10       by the configuration file in the order listed  below  with  the  latter
11       having highest precedence. Changes should be made to the local configu‐
12       rations.
13
14       /usr/lib/sddm/sddm.conf.d
15              System configuration directory
16
17       /etc/sddm.conf.d
18              Local configuration directory
19
20       /etc/sddm.conf
21              Local configuration file for compatibility
22

DESCRIPTION

24       This file configures various parameters of  the  sddm  display  manager
25       sddm(1).  If this file is not available, default values are used.
26

OPTIONS

28       [General] section:
29
30       DisplayServer=
31              Select  the display server to use for the greeter.  Valid values
32              are: * x11: X server running as root.  * x11-user: X server run‐
33              ning as unprivileged user.  * wayland: Wayland compositor as un‐
34              privileged user.  Default value  is  "x11".   For  x11-user  you
35              might need to configure Xorg.wrap(1).
36
37       HaltCommand=
38              Halt command.  Default value is "/usr/bin/systemctl poweroff".
39
40       RebootCommand=
41              Reboot command.  Default value is "/usr/bin/systemctl reboot".
42
43       Numlock=
44              Change numlock state when sddm-greeter starts.  Valid values are
45              on, off or none.  If property is set to none, numlock  won't  be
46              changed.  Default value is "none".
47
48       InputMethod=
49              Set  the  Qt input method for the greeter.  Tablet users with Qt
50              Virtual Keyboard installed can set this  to  "qtvirtualkeyboard"
51              for  the  on-screen keyboard.  Other known values are "ibus" for
52              the Intelligent Input Bus, or "compose" for dead  keys  support.
53              Leave this empty if unsure.
54
55       Namespaces=
56              Comma-separated list of paths bound to Linux namespaces to enter
57              with setns() before starting the user session.  For example,  to
58              enter  network  namespace mynet created with ip netns add mynet,
59              the value might be /run/netns/mynet.  Default  value  is  empty.
60              (The value is ignored if the operating system is not Linux.)
61
62       [Theme] section:
63
64       ThemeDir=
65              Path  of the directory containing theme files.  Default value is
66              "/usr/share/sddm/themes".
67
68       Current=
69              Name of the current theme.  By default this  setting  is  empty,
70              meaning the embedded theme will be used.
71
72       FacesDir=
73              Path  of  the directory containing face files, face files should
74              be   in   username.face.icon   format.    Default    value    is
75              "/usr/share/sddm/faces".
76
77       CursorTheme=
78              Name  of  the cursor theme to be set before starting the display
79              server.
80
81       CursorSize=
82              Cursor size to be set before starting the display server.
83
84       Font=  Name of the font to be set before starting the  display  server.
85              Please note that the theme can still override this option.
86
87       EnableAvatars=
88              When enabled, home directories are searched for ".face.icon" im‐
89              ages to display as their avatars. This can be slow on some  file
90              systems.  When disabled, all avatars will be default. Themes may
91              choose to hide them altogether.  Default value is true.
92
93       [X11] section:
94
95       ServerPath=
96              Path of the X server.  Default value is "/usr/bin/X".
97
98       ServerArguments=
99              Arguments to the X server.  Default value is "-nolisten tcp".
100
101       XephyrPath=
102              Path of the Xephyr.  Default value is "/usr/bin/Xephyr".
103
104       XauthPath=
105              Path of the Xauth.  Default value is "/usr/bin/xauth".
106
107       SessionDir=
108              Path of the directory containing session files.   Default  value
109              is "/usr/share/xsessions".
110
111       SessionCommand=
112              Path  of  script to execute when starting the user session. This
113              script receives the value of the "Exec" setting in  the  ".desk‐
114              top" file of the selected session and runs it.  Default value is
115              "/etc/X11/xinit/Xsession".
116
117       SessionLogFile=
118              Path to the user session log file, relative to the  home  direc‐
119              tory.  Default value is ".local/share/sddm/xorg-session.log".
120
121       UserAuthFile=
122              Path  to  the  Xauthority  file, relative to the home directory.
123              Default value is ".Xauthority".
124
125       DisplayCommand=
126              Path of script to execute when starting the display server.  The
127              script  will  be  executed as root when General.DisplayServer is
128              "x11",   otherwise   as   sddm   user.    Default    value    is
129              "/usr/share/sddm/scripts/Xsetup".
130
131       DisplayStopCommand=
132              Path of script to execute when stopping the display server.  The
133              script will be executed as root  when  General.DisplayServer  is
134              "x11",    otherwise    as   sddm   user.    Default   value   is
135              "/usr/share/sddm/scripts/Xstop".
136
137       MinimumVT=
138              Minimum virtual terminal number that will be used by  the  first
139              display.  Virtual  terminal number will increase as new displays
140              added.  This setting is no longer available since SDDM v0.20.
141
142       EnableHiDPI=
143              Enables Qt's automatic HiDPI scaling.  Can be either  "true"  or
144              "false".  Default value is "false".
145
146       [Wayland] section:
147
148       CompositorCommand=
149              Path  of  the  compositor  to execute when starting the greeter.
150              Default value is "weston --shell=fullscreen-shell.so".
151
152       SessionDir=
153              Path of the directory containing session files.   Default  value
154              is "/usr/share/wayland-sessions".
155
156       SessionCommand=
157              Path  of  script to execute when starting the user session. This
158              script receives the value of the "Exec" setting in  the  ".desk‐
159              top"  file of the selected session and run it.  Default value is
160              "/etc/sddm/wayland-session".
161
162       SessionLogFile=
163              Path to the user session log file, relative to the  home  direc‐
164              tory.  Default value is ".local/share/sddm/wayland-session.log".
165
166       EnableHiDPI=
167              Enables  Qt's  automatic HiDPI scaling.  Can be either "true" or
168              "false".  Default value is "false".
169
170       [Users] section:
171
172       DefaultPath=
173              Default path to set after successfully logging in.  This is also
174              where  SDDM  looks  for  programs.   Default  value is "/usr/lo‐
175              cal/bin:/usr/bin:/bin".
176
177       MinimumUid=
178              Minimum user id of the users to be listed in the user interface.
179              Default value is 1000.
180
181       MaximumUid=
182              Maximum user id of the users to be listed in the user interface.
183              Default value is 60000
184
185       HideUsers=
186              Comma-separated list of Users that shouldn't show up in the user
187              list.  Default value is empty.
188
189       HideShells=
190              Comma-separated  list  of Shells of users that shouldn't show up
191              in the user list.  Default value is empty.
192
193       RememberLastUser=
194              If this flag is true, LastUser value will updated on every  suc‐
195              cessful  login,  if false last user value won't be updated.  De‐
196              fault value is true.
197
198       RememberLastSession=
199              If this flag is true, LastSession value will  updated  on  every
200              successful  login, if false last session value won't be updated.
201              Default value is true.
202
203       [Autologin] section:
204
205       User=  Name of the user to automatically log in when the system  starts
206              first time.  Default value is empty.
207
208       Session=
209              Name  of  the  session  to  automatically log in when the system
210              starts first time.  Default value is empty.
211
212       Relogin=
213              If true and User and Session are set automatic login  will  kick
214              in  again on session exit, otherwise it will work only the first
215              time.  Default value is false.
216

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

SEE ALSO