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 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
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 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.
NOTE FOR DEVELOPERS: The Lumina desktop environment is not an application development toolkit/framework – it is only a system interface. If you want to create applications for users of the Lumina® desktop, simply create/install the registration file(s) for your application according to the XDG/FreeDesktop standards (the desktop entry, menu, and autostart specifications in particular – depending on the needs of your application). If you wish to reduce the number of additional dependencies for your application on a Lumina® system, simply write it using the Qt5 graphical toolkit and not the KDE-based variant/offshoot of Qt.