Post-Install Instructions
Please follow these instructions before starting LXQt for the first time.
Dependencies to Start LXQt
Required
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.
Recommended
breeze-icons-5.115.0 and desktop-file-utils-0.27
Optional
lightdm-1.32.0 or another Display Manager, e.g. sddm-0.20.0, and XScreenSaver-6.08
Final Configuration
Starting LXQt
You can start LXQt from a TTY, using xinit-1.4.2, or by using a graphical 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
EOF
startx
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.
![[Note]](../images/note.png)
Note
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".