- Simple Desktop Display Manager (SDDM) is a display manager (a graphical login program) for X11. SDDM was written from scratch in C++11 and supports theming via QML. It is the successor of the KDE Display Manager and is used in conjunction with KDE Frameworks 5, KDE Plasma 5 and KDE Applications 5.
- 1 Installation
- 2 Configuration
- 3 Troubleshooting
Install the package.
Then follow Display manager#Loading the display manager to start SDDM at boot.
The configuration file for SDDM can be found at
man sddm.conf for all options.
On systems controlled by systemd, everything should work out of the box, since SDDM defaults to using
systemd-logind for session management. The configuration file will therefore not be created at package installation time. SDDM offers a command for generating a sample configuration file with the default settings if you really want one:
# sddm --example-config > /etc/sddm.conf
SDDM supports automatic login through its configuration file, for example:
[Autologin] User=john Session=plasma.desktop
This configuration causes a KDE Plasma session to be started for user
john when the system is booted. Available session types can be found in
An option to autologin into KDE Plasma while simultaneously locking the session is not available 
You can add a script that activates the screensaver of KDE to the autostart as a workaround:
#!/bin/bash /usr/bin/qdbus-qt4 org.kde.screensaver /ScreenSaver SetActive true & exit 0
Unlock KDE Wallet automatically on login
Theme settings can be changed in the
breeze for the default Plasma theme.
Some themes are available in the AUR, for example AUR.
Set the main theme through the
Current value, e.g.
The default SDDM theme directory is
/usr/share/sddm/themes/. You can add your custom made themes to that directory under a seperate subdirectory. Study the files installed to modify or create your own theme.
To set the mouse cursor theme, set
CursorTheme to your preferred cursor theme.
Valid Plasma mouse cursor theme names are
Changing your avatar
You can simply put a png image named
username.face.icon into the default directory
/usr/share/sddm/faces/. Alternatively you can change the default directory to match your desires:
You can also put a png image named
.face.icon at the root of your home directory. However, you need to make sure that
sddm user can read that file.
If you want to enforce Numlock to be enabled, set
Numlock=on in the
- KDE Frameworks' System Settings contains an SDDM configuration module. Install package to use it.
- There is a Qt-based AUR in the AUR.
Hangs after login
Try removing ~/.Xauthority.
Alternatively, if your cursor turns to a black cross at the same time, and you are using zsh as your shell, you may be experiencing this bug. Follow the instructions in the previous link to fix the issue. This bug is expected to be fixed in the SDDM version subsequent to 0.11.0.
SDDM starts on tty1 instead of tty7
SDDM follows the systemd convention of starting the first graphical session on tty1. If you prefer the old convention where tty1 through tty6 are reserved for text consoles, uncomment and edit the "MinimumVT" variable, under section [XDisplay], in
[XDisplay] ... MinimumVT=7 ...
One or more users do not show up on the greeter
UIDrange should generally not be exposed to a Display manager.
SDDM only displays users with a UID in the range of 1000 to 65000 by default, if the UIDs of the desired users are below this value then you will have to modify this range. Modify your
sddm.conf to (for a UID of 501, say):
[Users] HideShells=/sbin/nologin,/bin/false # Hidden users, this is if any system users fall within your range, see /etc/passwd on your system. HideUsers=git,sddm,systemd-journal-remote,systemd-journal-upload # Maximum user id for displayed users MaximumUid=65000 # Minimum user id for displayed users MinimumUid=500 #My UID is 501
SDDM loads only US keyboard layout
SDDM loads the keyboard layout specified in
/etc/X11/xorg.conf.d/00-keyboard.conf. You can generate this configuration file by
localectl set-x11-keymap command. See Keyboard configuration in Xorg for more information.