How to customize a LightDM GTK greeter background and theme

The login screen comes from a LightDM greeter, so changing the desktop wallpaper does not necessarily change what appears before sign-in. For the LightDM GTK greeter, the supported configuration names the background file and GTK theme inside its greeter section. I checked the maintained greeter configuration template and the Debian package metadata for the commands and files used below.

Confirm that LightDM uses the GTK greeter

LightDM is the display manager. A greeter is the program that draws its login interface, and the GTK greeter is only one option. The background setting in this tutorial applies when your active greeter is lightdm-gtk-greeter.

cat /etc/lightdm/lightdm.conf
ls /etc/lightdm/lightdm.conf.d/
ls /etc/lightdm/lightdm-gtk-greeter.conf.d/

Look for a greeter-session setting that names lightdm-gtk-greeter, or for a distribution-owned file in the configuration directory. Do not copy GTK-greeter settings into a system that uses slick-greeter, web-greeter, or another greeter. Those programs read different settings.

Find the effective configuration file

The upstream GTK greeter template uses /etc/lightdm/lightdm-gtk-greeter.conf, but your distribution can also load files from lightdm-gtk-greeter.conf.d where a later file can override an earlier value.

sudo grep -R --line-number --extended-regexp '^[[:space:]]*(background|user-background|theme-name|icon-theme-name)[[:space:]]*=' /etc/lightdm

Keep the output before editing because it identifies a vendor file that already sets a background or theme.

Set a background image

Put the image in a system-readable location. The greeter runs before your desktop session, so a file under your home directory can fail when it lacks permission to traverse that directory.

sudo install -D -m 644 ~/Pictures/login-background.jpg /usr/share/backgrounds/login-background.jpg
sudoedit /etc/lightdm/lightdm-gtk-greeter.conf

Add or change the following lines in the file’s greeter section, use the exact path that you installed, and leave unrelated distribution settings in place.

[greeter]
background = /usr/share/backgrounds/login-background.jpg
user-background = false

The upstream template accepts an image path or a color value for background. Set user-background to false when your selected image must stay in place instead of a user wallpaper.

Choose the GTK theme and icon theme

The GTK greeter loads a GTK theme and icon theme by name, and those names must identify themes available to the greeter rather than only your signed-in desktop.

[greeter]
theme-name = Adwaita-dark
icon-theme-name = Adwaita
font-name = Sans 11

Start with a system-wide theme that is already installed. The GTK greeter template also supports cursor-theme-name and cursor-theme-size for the login pointer.

Check file access before restarting LightDM

Restarting LightDM ends your graphical session, so save work and verify the image path and permissions first.

namei -l /usr/share/backgrounds/login-background.jpg
sudo systemctl restart lightdm

Every directory in the path needs execute permission for the greeter to reach the file, and the file needs read permission. If the screen returns with the desktop wallpaper or a plain color, inspect every matching setting under /etc/lightdm again and check which greeter LightDM starts.

Use a distribution tool when it owns the configuration

Some distributions ship a settings application or a file under lightdm-gtk-greeter.conf.d. Prefer that distribution-owned path when it exists because package upgrades can preserve it more predictably than a hand-edited vendor file.

The configuration model stays the same: identify the active greeter, set an accessible image path, then decide whether user wallpapers can override it. The upstream GTK greeter template documents each setting, while the ArchWiki LightDM page helps map it to the greeter installed on your system.

Why the desktop theme does not control the login screen

LightDM starts the greeter before your user session, so it reads system configuration and system-accessible assets. Your desktop theme can change after sign-in without changing the greeter because the programs use different processes, settings, and permissions.

A custom greeter theme adds another boundary. It can expose different options or ignore GTK-specific keys, which is why the active greeter name is the first thing to verify when a background or theme setting does not apply.

Sources

Where is the LightDM GTK greeter configuration file?

The upstream file is /etc/lightdm/lightdm-gtk-greeter.conf. Your distribution can also load override files from /etc/lightdm/lightdm-gtk-greeter.conf.d, so inspect both locations before editing.

Why does my LightDM background setting not apply?

Check that LightDM starts lightdm-gtk-greeter, confirm that a later configuration file does not override background, and make sure the greeter can read every directory and the image file.