Skip to content

sddm

Display Manager (SDDM) configuration reference with practical command examples, font setup, avatar handling, and a complete annotated /etc/sddm.conf sample

Update /etc/sddm.conf with an example config`

  • This will set theme back to default 
sddm --generate-config > /etc/sddm.conf

Start daemon in test mode

sddm --test-mode

Avatar must be placed in /usr/share/sddm/faces for being able to read /etc/sddm.conf properly

cp -v default_avatar.png /usr/share/sddm/faces/

List available Terminus fonts on the system

fc-list | grep -i terminus

Configure SDDM to use the Terminus font

  • This means we use font "Terminus" with size "18"
Font=Terminus,18

Example config for /etc/sddm.conf

[Autologin]
Relogin=false
Session=
User=

[General]
DisplayServer=x11
GreeterEnvironment=
HaltCommand=/usr/bin/loginctl poweroff
InputMethod=qtvirtualkeyboard
Namespaces=
Numlock=none
RebootCommand=/usr/bin/loginctl reboot

[Theme]
Current=breeze
CursorSize=24
CursorTheme=Breeze
DisableAvatarsThreshold=7
EnableAvatars=true
FacesDir=/usr/share/sddm/faces
#Font=Terminus,18
ThemeDir=/usr/share/sddm/themes

[Users]
DefaultPath=/usr/local/bin:/usr/bin:/bin
HideShells=
HideUsers=
MaximumUid=60000
MinimumUid=1000
RememberLastSession=true
RememberLastUser=true
ReuseSession=true

[Wayland]
CompositorCommand=weston --shell=kiosk

EnableHiDPI=true
SessionCommand=/usr/share/sddm/scripts/wayland-session
SessionDir=/usr/local/share/wayland-sessions,/usr/share/wayland-sessions
SessionLogFile=.local/share/sddm/wayland-session.log

[X11]
DisplayCommand=/usr/share/sddm/scripts/Xsetup
DisplayStopCommand=/usr/share/sddm/scripts/Xstop
EnableHiDPI=true
ServerArguments=-nolisten tcp
ServerPath=/usr/bin/X
SessionCommand=/usr/share/sddm/scripts/Xsession
SessionDir=/usr/local/share/xsessions,/usr/share/xsessions
SessionLogFile=.local/share/sddm/xorg-session.log
XephyrPath=/usr/bin/Xephyr