LXQt is a lightweight QT based desktop environment, LXQt was originally a port of LXDE to QT (called LXDE-Qt), it was created due to LXDE maintainer Hong Jen Yee being dissatisfied with GTK 3, on 21 July 2013 the LXDE(-Qt) and Razor-qt projects merged creating LXQt.
- Install Alpine Linux
- Create a user account (optional but recommended)
- Enable the Community repository
- Install Xorg
Basic LXQt Desktop Installation
Starting dbus (desktop bus) service:
Enabling dbus to start on boot:
If dbus is not running it leads to issues like missing icons and keyboard shortcuts.
Setting up eudev on a desktop system is recommended:
For more details and advanced instructions see Device Manager.
With a display manager (DM)
If the packagehas been installed, SDDM may be started to log in graphically with your new user.
After correct operation is verified, sddm can be enabled to start up during boot:
From the command line
LXQt may be started with:
Localized keyboard layout
Preferences → LXQt Settings → Keyboard and Mouse → Keyboard Layout
Allowing shut down and reboot
To enable users to shut down the machine or reboot, the packagesand need to be installed.
A reboot is required to let it take effect.
Auto-mounting USB drives
To enable automatic mounting of USB drives, install these packages:
Depending on what devices you intend to mount, some additional packages may be needed:
To list descriptions of all gvfs- packages:
For browsing of network shares within LXQt that works with file associations, you can install the gvfs packages for the network protocols you use.
For example, to browse in a SMB/cifs windows network:
(Check: If the above may already be sufficient for gvfs to initiate the fuse kernel module. Else, try to identify if there are necessary steps in:)
The OpenRC script for fuse is in a separate package.
Then the fuse service can be started manually.
If it works, the fuse service can be added to start up automatically at boot time:
Enabling privilege escalation GUI
To enable the privilege escalation GUI for a doas/sudo user, you need to install, , and .
To have elogind run, either make them start automatically at system start:
or start them manually for this time only:
If you cannot add the CPU and System Statistics widgets to the panel, make sureand are installed.
Missing Icons and Fonts
By default a Desktop Environments needs icons.is a good start.
See Fonts for more information on fonts.
To enable different effects (transparency, for example)can be used.
After installation, add it to the Autostart section of the LXQt Session Settings.
The default configuration is available in /etc/xdg/picom.conf.example. For modifications, it can be copied to ~/.config/picom/picom.conf or ~/.config/picom.conf.
Either modify the config file to your taste, or change the Autostart command line options. For example,
picom --vsync -r 12 --no-fading-openclose -b.
User-specific configuration is stored in ~/.config/lxqt/.
LXQt themes are qss stylesheets. They are located in /usr/share/lxqt/themes/ or ~/.local/share/lxqt/themes.
Qt Palette colors can be modified in lxqt-config-appearence > Widget Style > Qt Palette. Custom palettes are saved in ~/.local/share/lxqt/palettes/.
Additional QT Styles
Several packages provide additional QT Styles:
They also provide additional cursors.
Adding the KEY=VAL
QT_QPA_PLATFORMTHEME=lxqt to the Environment section of the Session Settings is suggested by the LXQt developers. Then every Qt5 program can load the theme plugin.
Another option, however, is to to install the package Testing) and appending the line
QT_QPA_PLATFORMTHEME=qt5ct to the environmental settings in the Environment section of the Session Settings will allow you to achieve a unified appearance between apps. Then, in the LXQt Appearance Configuration, under Widget Style, set Qt Style to
When using themes found around the web, it is possible that they are dependant on different packages. Consider using, , and .