.\" Man page generated from reStructuredText.
.
.TH SDDM.CONF 5 "August 2015" "sddm 0.17.0" "sddm"
.SH NAME
sddm.conf \- sddm display manager configuration
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
Configuration loads all files in the configuration directories followed by the configuration file in the order listed below with the latter having the most precedent. Changes should be made to the local configurations.
.INDENT 0.0
.TP
.B \fB/usr/lib/sddm/sddm.conf.d\fP
System configuration directory
.TP
.B \fB/etc/sddm.conf.d\fP
Local configuration directory
.TP
.B \fB/etc/sddm.conf\fP
Local configuration file for compatibility
.UNINDENT
.SH DESCRIPTION
.sp
This file configures various parameters of the sddm display manager \fBsddm\fP(1).
If this file is not available, default values are used.
.SH OPTIONS
.sp
[General] section:
.INDENT 0.0
.TP
.B \fIHaltCommand=\fP
Halt command.
Default value is "/bin/systemctl poweroff".
.TP
.B \fIRebootCommand=\fP
Reboot command.
Default value is "/bin/systemctl reboot".
.TP
.B \fINumlock=\fP
Change numlock state when \fBsddm\-greeter\fP starts.
Valid values are \fIon\fP, \fIoff\fP or \fInone\fP\&.
If property is set to \fInone\fP, numlock won\(aqt be changed.
Default value is "none".
.TP
.B \fIInputMethod=\fP
Set the Qt input method for the greeter.
Tablet users with Qt Virtual Keyboard installed can set this
to "qtvirtualkeyboard" for the on\-screen keyboard.
Other known values are "ibus" for the Intelligent Input Bus,
or "compose" for dead keys support.
Leave this empty if unsure.
.UNINDENT
.sp
[Theme] section:
.INDENT 0.0
.TP
.B \fIThemeDir=\fP
Path of the directory containing theme files.
Default value is "/usr/share/sddm/themes".
.TP
.B \fICurrent=\fP
Name of the current theme.
By default this setting is empty, meaning the embedded theme
will be used.
.TP
.B \fIFacesDir=\fP
Path of the directory containing face files,
face files should be in username.face.icon format.
Default value is "/usr/share/sddm/faces".
.TP
.B \fICursorTheme=\fP
Name of the cursor theme to be set before starting
the display server.
.TP
.B \fIEnableAvatars=\fP
When enabled, home directories are searched for ".face.icon" images to
display as their avatars. This can be slow on some file systems.
When disabled, all avatars will be default. Themes may choose to hide
them altogether.
Default value is true.
.UNINDENT
.sp
[X11] section:
.INDENT 0.0
.TP
.B \fIServerPath=\fP
Path of the X server.
Default value is "/usr/bin/X".
.TP
.B \fIServerArguments=\fP
Arguments to the X server.
Default value is "\-nolisten tcp".
.TP
.B \fIXephyrPath=\fP
Path of the Xephyr.
Default value is "/usr/bin/Xephyr".
.TP
.B \fIXauthPath=\fP
Path of the Xauth.
Default value is "/usr/bin/xauth".
.TP
.B \fISessionDir=\fP
Path of the directory containing session files.
Default value is "/usr/share/xsessions".
.TP
.B \fISessionCommand=\fP
Path of script to execute when starting the user session. This script
receives the value of the "Exec" setting in the ".desktop" file of the selected
session and runs it.
Default value is "/etc/sddm/Xsession".
.TP
.B \fISessionLogFile=\fP
Path to the user session log file, relative to the home directory.
Default value is ".local/share/sddm/xorg\-session.log".
.TP
.B \fIUserAuthFile=\fP
Path to the Xauthority file, relative to the home directory.
Default value is ".Xauthority".
.TP
.B \fIDisplayCommand=\fP
Path of script to execute when starting the display server.
Default value is "/usr/share/sddm/scripts/Xsetup".
.TP
.B \fIDisplayStopCommand=\fP
Path of script to execute when stopping the display server.
Default value is "/usr/share/sddm/scripts/Xstop".
.TP
.B \fIMinimumVT=\fP
Minimum virtual terminal number that will be used
by the first display. Virtual terminal number will
increase as new displays added.
Default value is 7.
.TP
.B \fIEnableHiDPI=\fP
Enables Qt\(aqs automatic HiDPI scaling.
Can be either "true" or "false".
Default value is "false".
.UNINDENT
.sp
[Wayland] section:
.INDENT 0.0
.TP
.B \fISessionDir=\fP
Path of the directory containing session files.
Default value is "/usr/share/wayland\-sessions".
.TP
.B \fISessionCommand=\fP
Path of script to execute when starting the user session. This script
receives the value of the "Exec" setting in the ".desktop" file of the selected
session and run it.
Default value is "/usr/share/sddm/scripts/wayland\-session".
.TP
.B \fISessionLogFile=\fP
Path to the user session log file, relative to the home directory.
Default value is ".local/share/sddm/wayland\-session.log".
.TP
.B \fIEnableHiDPI=\fP
Enables Qt\(aqs automatic HiDPI scaling.
Can be either "true" or "false".
Default value is "false".
.UNINDENT
.sp
[Users] section:
.INDENT 0.0
.TP
.B \fIDefaultPath=\fP
Default path to set after successfully logging in.
Default value is "/bin:/usr/bin".
.TP
.B \fIMinimumUid=\fP
Minimum user id of the users to be listed in the
user interface.
Default value is 1000.
.TP
.B \fIMaximumUid=\fP
Maximum user id of the users to be listed in the
user interface.
Default value is 60000
.TP
.B \fIHideUsers=\fP
Comma\-separated list of Users that shouldn\(aqt show up in the user list.
Default value is empty.
.TP
.B \fIHideShells=\fP
Comma\-separated list of Shells of users that shouldn\(aqt show up in the user list.
Default value is empty.
.TP
.B \fIRememberLastUser=\fP
If this flag is true, LastUser value will updated
on every successful login, if false last user value
won\(aqt be updated.
Default value is true.
.TP
.B \fIRememberLastSession=\fP
If this flag is true, LastSession value will updated
on every successful login, if false last session value
won\(aqt be updated.
Default value is true.
.UNINDENT
.sp
[Autologin] section:
.INDENT 0.0
.TP
.B \fIUser=\fP
Name of the user to automatically log in when the
system starts first time.
Default value is empty.
.TP
.B \fISession=\fP
Name of the session to automatically log in when the
system starts first time.
Default value is empty.
.TP
.B \fIRelogin=\fP
If true and User and Session are set automatic login will
kick in again on session exit, otherwise it will work
only the first time.
Default value is false.
.UNINDENT
.SH SEE ALSO
.sp
\fBsddm\fP(1)
.sp
The full documentation for sddm is available at \fI\%https://github.com/sddm/sddm\fP
.\" Generated by docutils manpage writer.
.