LightDM is a cross-desktop display manager. It provides a lightweight and customizable login screen for Linux systems. LightDM supports multiple desktop environments and uses separate greeter applications to render the user interface.

LightDM Installation

Install LightDM on Debian-based systems:

$ sudo apt install lightdm

Install LightDM on Arch-based systems:

$ sudo pacman -S lightdm

Install a greeter package. The GTK greeter is the most common choice:

$ sudo apt install lightdm-gtk-greeter
Note: LightDM requires a greeter to display the login interface. Without a greeter, only automatic login works.

LightDM Configuration

The main configuration file is located at /etc/lightdm/lightdm.conf. Additional configuration files can be placed in /etc/lightdm/lightdm.conf.d/.

View Current LightDM Configuration

Display the effective configuration with source file locations:

$ lightdm --show-config

This command shows all active settings and identifies which configuration files define each option.

Change Default Display Manager

Switch to LightDM as the default display manager using dpkg-reconfigure:

$ sudo dpkg-reconfigure lightdm

Select LightDM from the list of available display managers.

Enable LightDM Service

Enable LightDM to start at boot. First disable any existing display manager:

$ sudo systemctl disable gdm

Enable the LightDM service:

$ sudo systemctl enable lightdm

Reboot the system to apply changes:

$ sudo systemctl reboot
Warning: Keep another display manager installed as backup. A misconfigured LightDM may prevent graphical login.

LightDM Autologin Setup

Configure automatic login by editing /etc/lightdm/lightdm.conf or creating a file in /etc/lightdm/lightdm.conf.d/.

Add these lines under the [Seat:*] section:

[Seat:*]
autologin-user=username
autologin-user-timeout=0

Replace username with the account name for automatic login.

Tip: Set autologin-user-timeout to a value greater than zero to display the greeter briefly before automatic login.

Enable LightDM User List

By default, LightDM requires users to type their username. Enable a clickable user list for easier selection.

Create the configuration file:

$ sudo nano /etc/lightdm/lightdm.conf.d/01_user-list.conf

Add this content:

[Seat:*]
greeter-hide-users=false

Restart LightDM to apply the change:

$ sudo systemctl restart lightdm

LightDM Greeter Configuration

Different greeters have their own configuration files. The GTK greeter uses /etc/lightdm/lightdm-gtk-greeter.conf.

Change Greeter Background

Edit the greeter configuration:

$ sudo nano /etc/lightdm/lightdm-gtk-greeter.conf

Set a custom background image:

[greeter]
background=/path/to/image.png

Use a solid color by specifying a hex value:

[greeter]
background=#2d2d2d

Change Default Session

Set the default desktop session in /etc/lightdm/lightdm.conf:

[Seat:*]
user-session=xfce

Available sessions are listed in /usr/share/xsessions/. List available sessions:

$ ls /usr/share/xsessions/

LightDM Test Mode

Test LightDM configuration without logging out. Install the Xephyr nested X server:

$ sudo apt install xserver-xephyr

Run LightDM in test mode:

$ lightdm --test-mode --debug

This opens LightDM in a window for testing greeter themes and configuration changes.

LightDM Greeters

Several greeter options are available for different desktop environments and visual preferences.

Greeter Description
lightdm-gtk-greeter Default GTK-based greeter with moderate resource usage
lightdm-slick-greeter Appearance-focused GTK greeter from Linux Mint
lightdm-webkit2-greeter HTML/CSS/JavaScript themeable greeter
lightdm-kde-greeter KDE Plasma integrated greeter

Set the active greeter in /etc/lightdm/lightdm.conf:

[Seat:*]
greeter-session=lightdm-slick-greeter

LightDM Troubleshooting

Check LightDM service status:

$ systemctl status lightdm

View LightDM logs for errors:

$ cat /var/log/lightdm/lightdm.log

View greeter-specific logs:

$ cat /var/log/lightdm/seat0-greeter.log
Note: Graphics driver issues commonly cause LightDM failures. Check X.org logs at /var/log/Xorg.0.log for display-related errors.

FAQs

LightDM is a display manager that handles graphical login sessions. It authenticates users, starts X or Wayland sessions, and launches desktop environments.

Add autologin-user=username under [Seat:*] in /etc/lightdm/lightdm.conf. Replace username with the target account name.

Black screen issues typically result from missing greeter packages or graphics driver problems. Install a greeter and check X.org logs for errors.

Edit the greeter configuration file. For GTK greeter, modify /etc/lightdm/lightdm-gtk-greeter.conf and set the theme and background options.

LightDM supports Wayland sessions. Install a Wayland-compatible greeter and configure the session type in the LightDM configuration file.

Willie has over 15 years of experience in Linux system administration and DevOps. After managing infrastructure for startups and enterprises alike, he founded Command Linux to share the practical knowledge he wished he had when starting out. He oversees content strategy and contributes guides on server management, automation, and security.