LXQt Desktop Final Instructions

Post-Install Instructions

Please follow these instructions before starting LXQt for the first time.

Dependencies to Start LXQt


openbox-3.6.1, or another window manager, such as Xfwm4-4.18.0, or kwin from Plasma-5.27.10. Note that IceWM-3.4.5 is not suitable for LXQt.



lightdm-1.32.0 or another Display Manager, e.g. sddm-0.20.0, and XScreenSaver-6.08

Final Configuration

LXQt Final Database Updates

The desktop databases need to be created or updated at this point. Run the following commands as the root user:

ldconfig                             &&
update-mime-database /usr/share/mime &&
xdg-icon-resource forceupdate        &&
update-desktop-database -q

Starting LXQt

You can start LXQt from runlevel 3, using xinit-1.4.2, or from runlevel 5, using a Display Manager, such as lightdm-1.32.0.

To start LXQt using xinit-1.4.2, run the following commands:

cat > ~/.xinitrc << "EOF"
exec startlxqt


The X session starts on the first unused virtual terminal, normally vt1. You can switch to another vtn by simultaneously pressing the keys Ctrl-Alt-Fn (n=2, 3, ...). To switch back to the X session, normally started at vt1, use Ctrl-Alt-F1. The vt where the command startx was executed will display many messages, including X starting messages, applications automatically started with the session, and eventually, some warning and error messages, but these are hidden by the graphical interface. You may prefer to redirect those messages to a log file, which can be used for debugging purposes. This can be done starting X with:

startx &> ~/.x-session-errors

Initial Configuration

When LXQt first starts, it will ask you for the window manager to use. To start, the BLFS editors recommend using openbox. At this point both the background and the panel will be black. Right clicking on the background will bring up a menu and selecting "Desktop Preferences" will allow you to change the background color or set a background image.

The panel will be at the bottom of the screen. Right clicking on the panel will bring up a menu that will allow you to customize the panel including adding widgets and setting the background color. The BLFS editors recommend installing, at a minimum, the Application Manager and Task Manager widgets.

After LXQt has started for the first time, the BLFS editors recommend going through the settings presented in the LXQt Configuration Center, which can be found under LXQt Settings in the Preferences menu of the application launcher.



The user configuration files will be created in the directory $HOME/.config/lxqt/. To get widget icons to display properly, the lxqt.conf file may need to be manually edited to include the line "icon_theme=oxygen".