LXQt Desktop Pre-Install Instructions



Due to recent changes in grep it is essential that the installing system be set to a UTF-8 locale. An example is export LANG=en_US.utf8, but any UTF-8 locale is sufficient. Failure to do this will result in a faulty installation.

LXQt can be installed in /usr or /opt/lxqt.

Installing in /usr

Installing in /usr creates a simpler setup. Run:

export LXQT_PREFIX=/usr

Either add that to your own .bash_profile so that it will still be set if you build the packages over a period of time, or else add it to the system profile as the root user:

cat > /etc/profile.d/lxqt.sh << "EOF"
# Begin LXQt profile

export LXQT_PREFIX=/usr

# End LXQt profile

The rest of this page is for people who wish to use the alternative prefix.

Installing in /opt/lxqt

Installing in /opt/lxqt may simplify upgrading to a later version of LXQt.

Some variables need to be defined in your system profile, as the root user:

install -vdm755 /opt/lxqt/{bin,lib,share/man}
cat > /etc/profile.d/lxqt.sh << "EOF"
# Begin LXQt profile

export LXQT_PREFIX=/opt/lxqt

pathappend /opt/lxqt/bin           PATH
pathappend /opt/lxqt/share/man/    MANPATH
pathappend /opt/lxqt/lib/pkgconfig PKG_CONFIG_PATH

# End LXQt profile

Expand your /etc/ld.so.conf file:

cat >> /etc/ld.so.conf << "EOF"

# Begin LXQt addition


# End LXQt addition


Before starting to install the packages in the following pages, remember to execute:

source /etc/profile

Some packages may also install icons from the "hicolor" icon set. Since that icon set is used by many packages, it is a good idea to create a symlink to the one in /usr/share to avoid having multiple installations of hicolor-icon-theme-0.15. Run the following commands as the root user:

source /etc/profile                                       &&
install -v -dm755                $LXQT_PREFIX/share/icons &&
ln -sfv /usr/share/icons/hicolor $LXQT_PREFIX/share/icons


Sometimes, the installation paths are hardcoded into installed files. This is the reason why /opt/lxqt is used as installation prefix instead of /opt/lxqt-0.10.0. After installing LXQt Desktop, you may rename the directory and create a symlink:

mv /opt/lxqt{,-0.10.0}
ln -sfv lxqt-0.10.0 /opt/lxqt

Later on, you may want to install other versions of LXQt Desktop. To do that, just remove the symlink and use /opt/lxqt as the prefix again. Which version of LXQt Desktop you use depends only on where the symlink points. No other reconfiguration will be needed.

Last updated on 2016-03-07 11:09:56 -0800