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

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

SEE ALSO