KDE: Difference between revisions

Latest revision as of 03:42, 21 November 2025

Plasma is the desktop environment from KDE, a software project comprising of a collection of libraries known as KDE Frameworks, and several applications known as KDE Applications. Their UserBase wiki has detailed information about most KDE Applications.

Prerequisites

Tip: Except for the first two Prerequisites, all the others are automatically handled if Plasma desktop is installed using setup-desktop script.

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 Elogind service
For users interested in Xorg as opposed to Wayland, install the Xorg base packages
Wayland users: Install package xf86-input-libinput

Installation

Note: The plasma-desktop-meta package, which is used by setup-desktop, isn't available for the armhf or s390x architectures. However, the rest of Plasma may be installed separately to potentially get a functional desktop.

setup-desktop

The Alpine Linux script for quickly setting up a desktop is:

# setup-desktop

On running the above command, you will be prompted to select a desktop environment.

Which desktop environment? ('gnome', 'plasma', 'xfce', 'mate', 'sway', 'lxqt' or 'none') [none]

Once you have chosen a desktop environment, this script installs the chosen desktop along with necessary packages, firefox browser and adds necessary services to run on startup. You can reboot when complete, and the system will boot into a graphical login screen with the chosen desktop environment, except for sway. To view the packages installed by the script: $ cat /usr/sbin/setup-desktop When Plasma is chosen, the above script additionally installs PipeWire for audio and SDDM as display manager.

Manual

The following command will install the Plasma desktop as specified by the plasma metapackage, including the sddm display manager and other assorted niceties.

# apk add plasma-desktop-meta

Note: polkit and udev are optional services for authentication and device management respectively. While KDE will function without these services enabled, some functionality may be missing or incomplete.

KDE Applications

To install the full set of KDE Applications, install kde-applications. You can also choose to install a smaller set of applications by installing any of the subpackages:

Note: kde-applications-edu, kde-applications-network and kde-applications-pim are not available on the ppc64le or s390x architectures.

Starting Plasma

Plasma can be started using a display manager or from the console.

Using a display manager

When Plasma is installed via the plasma meta-package, the display manager is set up using sddm.

Make sure you enable and start the SDDM service.

# rc-update add sddm # rc-service sddm start

Select Plasma to launch a new session in Wayland
Select Plasma (X11) to launch a new session in Xorg

From the console

For the Wayland session run:

$ XDG_SESSION_TYPE=wayland dbus-run-session startplasma-wayland

The Xorg session can be launched by installing xinit and appending exec startplasma-x11 to your .xinitrc file. To start X:

$ xinit

Discover

Discover is the application installer from KDE. The alpine linux package discover is automatically installed if plasma-desktop-meta package is installed or if setup-desktop is used to install Plasma.

Install the packages discover-backend-apk and discover-backend-flatpak to use Discover as a graphical interface to Alpine Package Keeper and Flatpak respectively.

Troubleshooting

HiDPI Scaling

When using high resolution screens, e.g. 4K, you might need to apply scaling so the fonts and windows are not too small.

In order to achieve this you can open Settings -> Display and Monitor and change the slider under Global Scale to an appropriate value.

You can also change the mouse cursor and icon size under Settings -> Appearance.

If your taskbar and window decorations are still too small, you might want to create the file ~/.xprofile to define the PLASMA_USE_QT_SCALING environment variable:

export PLASMA_USE_QT_SCALING=1

After creating this file, you may need to restart your session to apply this modification.

@@ Line 1: / Line 1: @@
-KDE is a software project comprising a desktop environment known as Plasma, a collection of libraries and frameworks known as KDE Frameworks, and several applications known as KDE Applications. Their [https://userbase.kde.org/Welcome_to_KDE_UserBase UserBase wiki] has detailed information about most KDE Applications.
+[[File:KDEScreenshot.png|thumb|KDE Plasma screenshot.]]
-{{Note|the {{Pkg|plasma}} package isn't available for the <code>ppc64le</code> and <code>s390x</code> architectures due to the {{Pkg|kdeplasma-addons}} dependency not being available there. However, the rest of Plasma can be installed separately to get a functional desktop.}}
+[https://kde.org/plasma-desktop/ Plasma] is the desktop environment from [https://kde.org/ KDE], a software project comprising of a collection of libraries known as [https://develop.kde.org/products/frameworks/ KDE Frameworks], and several applications known as [https://apps.kde.org/ KDE Applications]. Their [https://userbase.kde.org/Welcome_to_KDE_UserBase UserBase wiki] has detailed information about most KDE Applications.
-<br>
 == Prerequisites ==
-* [[Installation|Install]] AlpineLinux
+{{Tip|Except for the first two ''Prerequisites'', all the others are automatically handled if Plasma desktop is installed using [[#setup-desktop|setup-desktop]] script.}}
-* [[Post_installation#Creating_a_new_user_account|Create a user account]] (optional but recommended)
-* [[Post_installation#Repositories|Enable the Community repository]]
-* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]]
-{{Note|Wayland can be used but may be less stable and Plasma may still require Xorg}}
+{{:Include:Desktop prerequisites}}
+* Enable [[Elogind]] service
-<br>
+* For users interested in Xorg as opposed to Wayland, install the [[Alpine_setup_scripts#setup-xorg-base|Xorg base packages]]
+* Wayland users: Install package {{pkg|xf86-input-libinput|arch=}}
 == Installation ==
-==== Standard plasma installation ====
+{{Note|The {{Pkg|plasma-desktop-meta|arch=}} package, which is used by {{Ic|setup-desktop}}, isn't available for the {{Ic|armhf}} or {{Ic|s390x}} [[Alpine_Linux:Overview#Architectures|architectures]]. However, the rest of Plasma may be installed separately to potentially get a functional desktop.}}
-{{Cmd|# apk add plasma}}
+=== setup-desktop ===
-This will install the required Plasma packages, {{Pkg|sddm}} and pre-configure it to use the Breeze theme.
+{{:Include:Setup-desktop}}
+When Plasma is chosen, the above script additionally installs [[PipeWire]] for audio and [[SDDM]] as display manager.
-<br>
+=== Manual ===
-==== Lightweight plasma installation ====
+The following command will install the Plasma desktop as specified by the plasma metapackage, including the {{Pkg|sddm|arch=}} display manager and other assorted niceties. {{Cmd|# apk add {{pkg|plasma-desktop-meta|arch=}}}}
+{{Note|'''polkit''' and '''udev''' are optional services for authentication and device management respectively. While KDE will function without these services enabled, some functionality may be missing or incomplete.}}
-Alternatively, a smaller installation can be done:
+== KDE Applications ==
-{{Cmd|# apk add plasma-desktop systemsettings sddm breeze}}
+To install the full set of KDE Applications, install {{Pkg|kde-applications}}. You can also choose to install a smaller set of applications by installing any of the subpackages:
-<br>
+{{Note|{{Pkg|kde-applications-edu|arch=}}, {{Pkg|kde-applications-network|arch=}} and {{Pkg|kde-applications-pim|arch=}} are not available on the {{Ic|ppc64le}} or {{Ic|s390x}} [[Alpine_Linux:Overview#Architectures|architectures]].}}
-{{Note|If you are missing something that is in a standard Plasma installation check out the dependencies of the {{Pkg|plasma}} package because it is likely you will find whatever your missing there.}}
+* {{Pkg|kde-applications-accessibility|arch=}}
+* {{Pkg|kde-applications-admin|arch=}}
+* {{Pkg|kde-applications-base|arch=}}
+* {{Pkg|kde-applications-edu|arch=}}
+* {{Pkg|kde-applications-games|arch=}}
+* {{Pkg|kde-applications-graphics|arch=}}
+* {{Pkg|kde-applications-multimedia|arch=}}
+* {{Pkg|kde-applications-network|arch=}}
+* {{Pkg|kde-applications-pim|arch=}}
+* {{Pkg|kde-applications-sdk|arch=}}
+* {{Pkg|kde-applications-utils|arch=}}
+* {{Pkg|kde-applications-webdev|arch=}}
+== Starting Plasma ==
+Plasma can be started using a display manager or from the console.
-<br>
+=== Using a display manager ===
-== KDE Applications ==
+When Plasma is installed via the plasma meta-package, the display manager is set up using sddm.
+Make sure you enable and start the SDDM service.
+{{Cmd|<nowiki># rc-update add sddm
+# rc-service sddm start </nowiki>}}
+* Select ''Plasma'' to launch a new session in Wayland
+* Select ''Plasma (X11)'' to launch a new session in Xorg
+=== From the console ===
-To install the full set of KDE Applications, install {{Pkg|kde-applications}}. You can also choose to install a smaller set of applications by installing any of the subpackages:
+For the Wayland session run:
-* {{Pkg|kde-applications-accessibility}}
+{{Cmd|$ XDG_SESSION_TYPE{{=}}wayland dbus-run-session startplasma-wayland}}
-* {{Pkg|kde-applications-admin}}
-* {{Pkg|kde-applications-base}}
-* {{Pkg|kde-applications-edu}}, not available for <code>ppc64le</code> and <code>s390x</code>
-* {{Pkg|kde-applications-games}}
-* {{Pkg|kde-applications-graphics}}
-* {{Pkg|kde-applications-multimedia}}
-* {{Pkg|kde-applications-network}}, not available for <code>ppc64le</code> and <code>s390x</code>
-* {{Pkg|kde-applications-pim}}, not available for <code>ppc64le</code> and <code>s390x</code>
-* {{Pkg|kde-applications-sdk}}
-* {{Pkg|kde-applications-utils}}
-* {{Pkg|kde-applications-webdev}}
-<br>
+The Xorg session can be launched by installing {{Pkg|xinit|arch=}} and appending {{Ic|exec startplasma-x11}} to your {{Path|.xinitrc}} file. To start X:
-== Starting Plasma ==
+{{Cmd|$ xinit}}
-Plasma can be started using a display manager or from the console.
+== Discover ==
-==== Using a display manager ====
+[https://userbase.kde.org/Discover Discover] is the application installer from KDE. The alpine linux package {{pkg|discover}} is automatically installed if {{pkg|plasma-desktop-meta|arch=}} package is installed or if [[#setup-desktop|setup-desktop]] is used to install Plasma.
-When Plasma is installed via the {{Pkg|plasma}} meta-package, the display manager is set up using {{Pkg|sddm}}.
+Install the packages {{pkg|discover-backend-apk}} and {{pkg|discover-backend-flatpak}} to use Discover as a graphical interface to [[Alpine Package Keeper]] and [[Flatpak]] respectively.
-Make sure you enable and start the SDDM service.
+== Troubleshooting ==
-<pre>
+=== HiDPI Scaling ===
-rc-update add sddm
-rc-service sddm start
-</pre>
-* Select ''Plasma'' to launch a new session in Wayland
+When using high resolution screens, e.g. 4K, you might need to apply scaling so the fonts and windows are not too small.
-* Select ''Plasma (X11)'' to launch a new session in Xorg
-==== From the console ====
+In order to achieve this you can open {{Ic|Settings -> Display and Monitor}} and change the slider under ''Global Scale'' to an appropriate value.
-The Xorg session can be launched by installing {{Pkg|xinit}} and appending <code>exec startplasma-x11</code> to your <code>.xinitrc</code> file. To start X:
+You can also change the mouse cursor and icon size under {{Ic|Settings -> Appearance}}.
-{{Cmd|xinit}}
-For the Wayland session run
+If your taskbar and window decorations are still too small, you might want to create the file {{path|~/.xprofile}} to define the ''PLASMA_USE_QT_SCALING'' environment variable:{{Cmd|export PLASMA_USE_QT_SCALING{{=}}1}}
-<pre>
-XDG_SESSION_TYPE=wayland dbus-run-session startplasma-wayland
-</pre>
-<br>
+After creating this file, you may need to restart your session to apply this modification.
 == See also ==
-* [[Alpine newbie]]
-* [[Post installation]]
+* [[Installation#Post-Installation|Post installation]]
 * [[Flatpak]]
+* [https://wiki.archlinux.org/title/KDE KDE - Archwiki]
-[[Category:Desktop]]
+[[Category:Desktop Environments]]