Lumina: Difference between revisions

Latest revision as of 15:38, 6 January 2026

This material is work-in-progress ...

Do not follow instructions here until this notice is removed.
(Last edited by D1nuc0m on 6 Jan 2026.)

Lumina is a lightweight desktop environment. Mainly used on *BSD systems, does not rely on Linux desktop frameworks/tools such as systemd.

Prerequisites

Without D-Bus

Consider if upgrade to Edge, as Lumina requires testing repository, unsupported on main/stable branches.
Enable community and testing repositories
Install Xorg

With D-Bus

Consider if upgrade to Edge, as Lumina requires testing repository, unsupported on main/stable branches.
Internet connectivity, unless the packages have been pre-fetched into a local cache.
Install appropriate Graphics driver drivers for your hardware. Without graphics drivers, errors are likely to occur when starting your desktop.
A non-root user account with appropriate groups for desktop usage.
The community repository must be enabled.
Set up eudev.
Install and enable D-Bus. Without D-Bus, icons and keyboard shortcuts may be missing.
Enable testing repository
Install Xorg

Installation

Install the Lumina desktop environment packages

# apk add lumina-desktop

Install a terminal emulator with fonts to access the terminal from inside the desktop session, for example xterm

# apk add xterm font-terminus

Fixes

At the moment of writing, there are missing dependencies related to icons in the packages

# apk add qt5-qtsvg

Starting Lumina

With a display manager

ToDo

Manually

$ start-lumina-desktop

Setting Lumina as the default Desktop Environment

Without D-Bus

$ echo 'exec start-lumina-desktop' >> ~/.xinitrc

With D-Bus

$ echo 'exec dbus-launch --exit-with-session start-lumina-desktop' >> ~/.xinitrc

@@ Line 4: / Line 4: @@
 == Prerequisites ==
+=== Without D-Bus ===
 <!-- Do NOT {{:Include:Desktop prerequisites}} -->
-<!-- They include software not needed by Lumina -->
+<!-- They include D-Bus and other that Lumina does not depend on -->
+* Consider if [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge|upgrade to Edge]], as Lumina requires testing repository, unsupported on main/stable branches.
+* Enable [[Repositories#Enabling_the_community_repository|community]] and [[Repositories#Testing|testing]] repositories
+<!-- ToDo - script seem to add dbus? -->
+* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]]
+=== With D-Bus ===
 * Consider if [[Upgrading_Alpine_Linux_to_a_new_release_branch#Upgrading_to_Edge|upgrade to Edge]], as Lumina requires testing repository, unsupported on main/stable branches.
-* Enable [[Repositories#Enabling_the_community_repository|community]] and [[Repositories#Testing|testing]] repositories
+{{:Include:Desktop prerequisites}}
+* Enable [[Repositories#Testing|testing]] repository
 * [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]]
-* Install [[Fluxbox]]
 == Installation ==
@@ Line 24: / Line 33: @@
 == Fixes ==
-At the moment of writing, default icons in Lumina packages are broken, so it is necessary to install an icon theme like Oxygen
+At the moment of writing, there are missing dependencies related to icons in the packages
-{{Cmd|# apk add {{Pkg|oxygen-icons}} }}
+{{Cmd|# apk add {{Pkg|qt5-qtsvg}} }}
-and enable it in <code>Lumina Theme Engine/Icons</code>
 == Starting Lumina ==
@@ Line 41: / Line 48: @@
 == Setting Lumina as the default Desktop Environment ==
+=== Without D-Bus ===
 {{Cmd|$ echo 'exec start-lumina-desktop' >> ~/.xinitrc}}
-Or if using [[Dbus]]
+=== With D-Bus ===
 {{Cmd|$ echo 'exec dbus-launch --exit-with-session start-lumina-desktop' >> ~/.xinitrc}}
+[[Category:Desktop Environments]]
+== See also ==
+* [[Desktop environments and Window managers]]
+* [[Installation#Post-Installation|Post Install]]