Install the package, or for the GTK3 version. The development package is AUR.
The configuration files for LXDM are all located in
/etc/lxdm/. The main configuration file is
lxdm.conf, and is well documented in its comments. Another file,
Xsession, is the systemwide x session configuration file and should generally not be edited. The other files in this folder are all shell scripts, which are run when certain events happen in LXDM.
LoginReadyis executed with root privileges when LXDM is ready to show the login window.
PreLoginis run as root before logging a user in.
PostLoginis run as the logged-in user right after he has logged in.
PostLogoutis run as the logged-in user right after he has logged out.
PreRebootis run as root before rebooting with LXDM.
PreShutdownis run as root before poweroff with LXDM.
It can be specified which session will be loaded when the users select the 'Default' session from the session list. Note that the user setting takes preference over global setting.
/etc/lxdm/lxdm.conf and change the session line to whatever session or DE is desired:
Example using Xfce:
Example using Openbox:
Example using GNOME:
This is useful for themes that have no visible session selection box, and if experiencing trouble using autologin.
To define an individual user's preferred session, simply edit his/her respective
~/.dmrc to define the selection.
Example: user1 wants Xfce4, user2 wants Cinnamon, and user3 wants GNOME:
To log in to one account automatically on startup, without providing a password, find the line in
/etc/lxdm/lxdm.conf that looks like this:
Uncomment it, substituting the target user instead of dgod.
Last used options
It stores information about last used options in the:
[base] last_session=/usr/share/xsessions/LXDE.desktop last_lang=sv_SE.UTF-8 last_langs=sv_SE.UTF-8 fa_IR.UTF-8 en_US.UTF-8
Tips and tricks
Adding face icons
A 96x96 px image (jpg or png) can optionally be displayed on a per-user basis replacing the stock icon. Simply copy or symlink the target image to
$HOME/.face. The package supplies some default icons suitable for the lxdm screen. Look under
/usr/share/pixmaps/faces after installing that package.
- Users need not keep installed to use this images. Simply install it, copy them elsewhere, and remove it.
- The user's directory needs have r-x permissions for others and the .face file needs have r-- permissions for others. Obviously though this has security and access implications as now anyone can browse your home directory.
- A graphical tool
lxdm-configshipped with lxdm can be used to place a
.facefile in the home directory, along with other configuration.
Simultaneous users and switching users
LXDM allows multiple users to be logged into different ttys at the same time. The following command is used to allow another user to login without logging out the current user:
$ lxdm -c USER_SWITCH
The LXDM themes are located in
There is only one theme provided with LXDM, namely Industrial. To display the background file
wave.svg which is part of this theme, make sure you have installed.
AUR provides 6 extra themes. Archlinux, ArchlinuxFull, ArchlinuxTop, Arch-Dark, Arch-Stripes and IndustrialArch. The ArchStripes and ArchDark themes are also provided with AUR (with different names to avoid file conflicts).
You can configure them on
## the theme of greeter theme=theme_name
You can also configure LXDM to use a GTK theme (stored in
/usr/share/themes) on the mentioned configuration file:
## GTK theme gtk_theme=gtk_theme_name
Advanced Session Configuration
After a user logs on, LXDM sources all of the following files, in order:
These files can be used to set session environment variables and to start services which must set certain environment variables in order for clients in the session to be able to use the service, like ssh-agent. See Xprofile for details.
Note that LXDM does not source
~/.xinitrc, so those migrating from a DM that does use this file, like SLiM, will have to move their settings elsewhere — probably
~/.xprofile. Also note LXDM does not source
If you still want to use your
~/.xinitrc file, you can add a line to the
/etc/lxdm/PostLogin event file:
When using the default LXDM
theme=Industrial and a dark background image (e.g.
bg=/usr/share/backgrounds/img.png) there may be a short bright flash before LXDM starts. This is caused by the
bg_color: property of the selected GTK theme. To avoid this change
gtk_theme=Adwaita-dark or to another dark theme.
If you had trouble logging out when using lxdm (e.g. stuck, display freeze, etc..) try uncomment the
reset=1 option in
/etc/lxdm/lxdm.conf to refresh xserver on every logout.