The recommended way of trying out the Lumina® desktop is by installing TrueOS®. Lumina® is also available on many other operating system with varying levels of support, and we list some of them below for convenience. Please note that the packages we list are just the ones that we know about – Lumina® can easily be installed on almost any Unix-like OS, so please search your current package system to see if a package exists if you don’t see one listed here.
NOTE: The Lumina project does not provide pre-compiled binaries of any kind. Any issues with a pre-built package (such as getting it updated to the latest version) should be submitted to the associated package maintainer.
|Operating System||Control Panel||App Store||OS RSS Feed||List Mounted Devices||Screen Brightness||Audio Volume||Graphical Mixer||Shutdown Options||Suspend Support||Battery Monitor||Checksums||Disk Space||CPU/Memory Stats||Disk R/W Stats|
|TrueOS||SysAdm||AppCafe||Yes||Yes||Hardware & Software||mixer||pc-mixer||Detect/Allow||Detect/Allow||Full (apm)||md5||Yes||Yes (sysctl)||Yes (iostat)|
|FreeBSD||(SysAdm)||(AppCafe)||Yes||Yes||Hardware & Software||mixer||pc-mixer||Detect/Allow||Detect/Allow (pc-sysconfig)||Full (apm)||md5||Yes||Yes (sysctl)||Yes (iostat)|
|OpenBSD||none||none||No||Yes||Hardware (xbacklight)||mixerctl||none||Detect/Allow||none||Full (apm)||md5||Yes||No||No|
|DragonflyBSD||none||none||Yes||Yes||Software (xbrightness)||mixer||none||Allow||none||Full (sysctl)||md5||Yes||Yes (sysctl)||No|
|Gentoo Linux||none||Porthole||No||Yes||Hardware (xbacklight)||amixer||pavucontrol||Detect/Allow||Detect/Allow||acpi (no estimates)||md5sum||Yes||Yes (top)||Yes (iostat)|
|Debian Linux||none||Synaptic||No||Yes||Hardware (xbacklight)||amixer||pavucontrol||Detect/Allow||Detect/Allow||acpi (no estimates)||md5sum||Yes||Yes (top)||Yes (iostat)|
|Generic Linux||none||none||No||Yes||Hardware (xbacklight)||amixer||pavucontrol||Allow||none||acpi (no estimates)||md5sum||Yes||No||No|
Installing Lumina® from packages (recommended)
- Arch Linux AUR packages
- Fedora Packages
- FreeBSD packages
- Gentoo Linux packages
- Manjaro Linux packages
- OpenBSD packages
- OpenSUSE packages
- TrueOS packages
- PCLinuxOS packages
- Slackware packages
- Void Linux packages
Installing Lumina® from source code
- Building Lumina from source on Debian/Ubuntu/Linux Mint
- Building Lumina from source on Fedora/CentOS
- Building Lumina from source code (generic)
Installing Lumina® packages on Arch Linux
The Lumina® desktop is available in Arch Linux’s AUR repository as the lumina-desktop package. You can download and install the lumina-desktop file by running the following commands on Arch Linux:
curl -L -O https://aur.archlinux.org/cgit/aur.git/snapshot/lumina-desktop.tar.gz
Installing Lumina® packages on Fedora
The Lumina® desktop and it’s utilities are available on the official Fedora package repositories.
The desktop may be installed by running:
sudo dnf install lumina-desktop
Similarly, there are stand-alone packages available for various Lumina® desktop utilities, such as the file manager:
sudo dnf install lumina-fm
The package manager should take care of the details of installing Lumina® and also install the desktop’s dependencies. Afterward Lumina® will be available as a session option from Fedora’s login screen. Please note, some people have reported they had to reboot their computer before Lumina® would appear as a session option on the login screen.
Installing Lumina® packages on FreeBSD
Lumina® can be installed on FreeBSD either from the project’s package repositories or from FreeBSD’s ports collection. To install Lumina® as a package, run:
(Enter the root user’s password.)
pkg install lumina
Alternatively, Lumina® may be installed from the ports collection by running the following commands:
(Enter the root user’s password.)
(Wait while the port is compiled.)
Installing Lumina® packages on Gentoo Linux
Lumina® can be installed on Gentoo Linux through the “emerge” system. To install Lumina® as a package, run:
sudo emerge -a x11-wm/lumina
Installing Lumina® packages on Manjaro Linux
The Manjaro Linux distribution includes Lumina® desktop packages in the project’s Community repositories. To install the Lumina® desktop environment on a Manjaro system either install the lumina-desktop package from the graphical package manager or run the following command:
sudo pacman -S lumina-desktop
Lumina® should then be available as a session option from the graphical login screen.
Installing Lumina® packages on OpenBSD
Then run the following command
sudo pkg_add lumina
Note: On OpenBSD 5.8+, the sudo utility was replaced with doas
Installing Lumina® packages on OpenSUSE
To install Lumina® packages on the OpenSUSE operating system, just install the “lumina-desktop” package available in the OpenSUSE package repository.
Installing Lumina® packages on PC-BSD
The Lumina® desktop is available as a package in the software repositories. To install Lumina® on PC-BSD, run the following command:
sudo pkg install lumina
Installing Lumina® packages on PCLinuxOS
The Lumina® desktop is available as a package in the PCLinuxOS testing software repositories. To install Lumina® on PCLinuxOS, run the following commands as the root user:
apt-get install lumina-desktop
Installing Lumina® packages on Slackware
Lumina® is available to users of Slackware through the SlackBuilds repository of build scripts. The following steps will install the Lumina® package on an installation of Slackware that has been set up with the Full collection of official Slackware packages. Please note the comments in parenthesis should not be typed, they suggestions rather than literal commands.
tar xzf qt5.tar.gz
(check qt5.info text file for exact DOWNLOAD path)
(enter root password)
(wait a few hours)
tar xzf lumina.tar.gz
(check lumina.info text file for exact DOWNLOAD path)
(enter root password)
With the above steps completed, Lumina will be made a session option from Slackware’s graphical login screen.
Installing Lumina® packages on Void Linux
The Lumina® desktop is available as a pre-built package from the default repository on Void Linux.
Building Lumina® from source on Debian/Ubuntu/Linux Mint
To build the Lumina® desktop from source code on any members of the Debian, Ubuntu or Linux Mint distribution (or their derivative distributions) please perform the following steps.
Please note that older versions of Ubuntu (14.04 and earlier) do not ship with modern versions of the Qt 5 libraries. The following instructions should work for Debian 8 and Ubuntu 14.10 and earlier.
1. First, install the required software and build tools. Please note the “sudo apt-get install build-essential.. command is all one long command. There should be no line breaks between “build-essential” and “pavucontrol”.
sudo apt-get update
sudo apt-get install build-essential git qt5-default qttools5-dev-tools libqt5gui5 qtmultimedia5-dev libqt5multimediawidgets5 libqt5network5 libqt5svg5-dev libqt5x11extras5-dev libxcb-icccm4-dev libxcb-ewmh-dev libxcb-composite0-dev libxcb-damage0-dev libxcb-util0-dev libphonon-dev libxcomposite-dev libxdamage-dev libxrender-dev libxcb-image0-dev libxcb-screensaver0-dev qtdeclarative5-dev fluxbox kde-style-oxygen xscreensaver xbacklight alsa-utils acpi numlockx pavucontrol xterm sysstat
Next we need to download the Lumina source code.
git clone https://github.com/trueos/lumina.git
Our next step is to configure and build Lumina’s source code.
Note that after running qmake, there should be a message about detecting Debian for the OS-compatibility – otherwise you may need to run “qmake LINUX_DISTRO=Debian”
Finally, we build and install the desktop. These steps will likely take several minutes to complete.
sudo make install
At this point we can log out of our current desktop session and we should find the Lumina® session has been added as an option to our login screen.
Building Lumina from source on Fedora/CentOS
To install the Lumina® desktop on Fedora or CentOS, please perform the following steps.
1. First we need to make sure all the necessary dependencies are in place. On recent versions of Fedora we run the “dnf” package manager, but on older versions of Fedora or CentOS we can substitute “dnf” for “yum” in the following command. Please note the command shown here is all one long command.
sudo dnf -y install gcc gcc-c++ git qt-devel qt-config qt5-qttools qt5-qttools-devel qt5-qtbase-gui qt5-qtmultimedia-devel qt5-qtsvg-devel qt5-qtx11extras-devel xcb-util-image xcb-util-image-devel xcb-util-wm-devel libxcb-devel xcb-util-devel phonon-devel phonon-qt5-devel libXcomposite-devel libXdamage-devel libXrender-devel qt5-qtdeclarative-devel fluxbox qt5-style-oxygen plasma-oxygen xscreensaver xbacklight alsa-utils acpi numlockx pavucontrol xterm
2. Our next step is to download the Lumina® source code:
git clone http://github.com/trueos/lumina.git
3. Now we move into the Lumina® source directory and build the desktop. These commands may take several minutes to complete.
4. Finally, we install the Lumina® desktop on our system.
sudo make install
Logging out now should show the Lumina® desktop has been added to the list of available sessions we can access from the login screen.
Building Lumina® from source code (generic)
Lumina® can be built from source code on most Linux distributions and flavours of BSD. To compile Lumina® from source, perform the following steps:
1) Make sure the dependencies for your platform have been installed. A full list of Lumina’s dependencies is listed in the DEPENDENCIES file.
2) Follow the build instructions listed on the Lumina git repository for compiling from sources.