From Gentoo Wiki
Jump to:navigation Jump to:search
This page is a translated version of the page KDE and the translation is 10% complete.
Outdated translations are marked like this.

KDE це спільнота, поєднана навколо вільного програмного забезпечення, яка створює широкий асортимент прикладних програм, серед яких і оточення робочого столу Plasma.

Gentoo має чудову підтримку KDE, із зрозумілим розподілом на пакети успадкованого KDE SC 4, нового покоління KDE Frameworks, Plasma, та Applications 5, так само добре, як і широкого спектру іншого різноманітного програмного забезпечення, створеного на базі KDE.

Попередні вимоги


Read relevant documentation before performing any profile changes.

Вибір відповідного профілю, хоч і не потрібно, але рекомендується, так як він встановлює ряд глобальних і пакетних USE-прапорів для більш простої установки і не вимагає великого досвіду в налаштуванні KDE.

Щоб обрати найбільш слушний профіль, по-перше, подивіться перелік доступних:

root #eselect profile list
  [1]   default/linux/amd64/13.0
  [2]   default/linux/amd64/13.0/selinux
  [3]   default/linux/amd64/13.0/desktop
  [4]   default/linux/amd64/13.0/desktop/gnome
  [5]   default/linux/amd64/13.0/desktop/gnome/systemd
  [6]   default/linux/amd64/13.0/desktop/kde
  [7]   default/linux/amd64/13.0/desktop/kde/systemd
  [8]   default/linux/amd64/13.0/desktop/plasma
  [9]   default/linux/amd64/13.0/desktop/plasma/systemd

Потім виберіть правильний профіль, замінивши X на відповідний номер профілю:

root #eselect profile set X

Для повного оточення робочого столу KDE рекомендується використовувати профіль desktop/kde, який адаптований для використання з OpenRC. Якщо використовується systemd, виберіть desktop/kde/systemd. Для оточення робочого столу Plasma 5 виберіть відповідно desktop/plasma з OpenRC або desktop/plasma/systemd з systemd.


Перед установкою KDE SC рекомендується налаштувати декілька сервісів. Якщо використовується профіль "desktop/kde" або "desktop", то частина роботи робиться автоматично. Ось необхідні сервіси:

  • D-Bus: Включає використання системи взаємодії між процесами D-Bus.
  • Polkit: Включає набір інструментів polkit для контролю привілеїв системних сервісів.
  • udev: Включає підтримку динамічного і постійного іменування пристроїв Linux через udev.
  • Udisks: Включає підтримку деяких сервісів, пов'язаних зі зберіганням даних.

Session tracker

Choose exactly one of:

  • elogind: Standalone logind package, default for desktop/plasma profile, extracted from systemd project for use with OpenRC or other init systems.
  • systemd: Uses the session tracker part of systemd. Users of systemd do not need to take any other initiative here.

Device manager

Choose exactly one of:

  • udev: Enables support for udev Linux dynamic and persistent device naming.
  • eudev: Fork of udev for better compatibility with older kernels and various toolchains.
  • systemd: Uses the device manager part of systemd. Users of systemd do not need to take any other initiative here.


  • D-Bus: Enables use of the D-Bus message bus system.
  • polkit: Enables the polkit framework for controlling privileges for system-wide services.
  • udisks: Enables support for some storage related services.


Прочитайте та дотримуйтесь інструкцій, наведених у статті X-сервер, щоб налаштувати X-оточення.


Plasma 5 is the current generation of KDE's desktop environment, based on Qt 5 and KDE Frameworks 5.

Available versions

KDE Gentoo Ebuild repository Status
KDE Plasma 5.26.5 kde-plasma/plasma-meta-5.26.5 gentoo Stable for amd64, arm64, and x86; Testing for arm, loong, ppc64, riscv
KDE Plasma 5.27.2 kde-plasma/plasma-meta-5.27.2 gentoo Testing for amd64, arm, arm64, loong, ppc64, riscv and x86
KDE Plasma master branch kde-plasma/plasma-meta-9999 KDE Live version
Before proceeding, make sure to choose a Plasma profile.


USE flags

The kde-plasma/plasma-meta package provides the full Plasma 5 desktop, configurable by a wealth of USE flags:

USE flags for kde-plasma/plasma-meta Merge this to pull in all Plasma 5 packages

accessibility Add support for accessibility (eg 'at-spi' library)
bluetooth Enable Bluetooth Support
browser-integration Enable integration with Chrome/Firefox with browser extensions
colord Enable kde-plasma/kwin color management via x11-misc/colord
crash-handler Pull in kde-plasma/drkonqi for assisted upstream crash reports
crypt Pull in kde-plasma/plasma-vault for encrypted vaults integration
desktop-portal Enable sys-apps/xdg-desktop-portal backend implementation for Plasma
discover Pull in resources management GUI; a centralised GHNS alternative and optional sys-apps/fwupd frontend
display-manager Pull in a graphical display manager
elogind Enable session tracking via sys-auth/elogind
firewall Pull in kde-plasma/plasma-firewall for system firewall administration
grub Pull in Breeze theme for sys-boot/grub
gtk Enable Breeze widget style and system settings module for GTK+
handbook Enable handbooks generation for packages by KDE
kwallet Enable support for KWallet auto-unlocking via kde-plasma/kwallet-pam
legacy-systray Add support for legacy applications using kde-plasma/xembed-sni-proxy
networkmanager Enable net-misc/networkmanager support
plymouth Pull in Breeze theme for sys-boot/plymouth
pulseaudio Install Plasma applet for PulseAudio volume management
sddm Pull in the x11-misc/sddm display manager and system settings module
sdk Pull in kde-plasma/plasma-sdk for Plasma development
smart Pull in kde-plasma/plasma-disks for disk health monitoring
systemd Enable use of systemd-specific libraries and features like socket activation or session tracking
thunderbolt Pull in kde-plasma/plasma-thunderbolt control center module
wallpapers Install wallpapers for the Plasma Workspace


root #emerge --ask kde-plasma/plasma-meta

Alternatively, kde-plasma/plasma-desktop provides a very basic desktop, leaving users free to install only the extra packages they require - or rather, figure out missing features on their own.

Please note that installing just kde-plasma/plasma-desktop will exclude important packages needed for KDE Plasma to function, such as kde-plasma/powerdevil (power management, suspend and hibernate options), kde-plasma/systemsettings, and many more. This package should be used with the understanding that additional packages will need to be installed to ensure a functioning environment. Do not expect support when using this package.

Starting Plasma

Display manager

SDDM (Simple Desktop Display Manager) is the recommended login manager and is pulled in automatically via kde-plasma/plasma-meta by default. This is the preferred option. Alternatively, LightDM can be used and pulled in by setting USE flag -sddm for kde-plasma/plasma-meta. Change the setting accordingly in /etc/conf.d/display-manager. Also, be sure to read through the SDDM page if further issues appear.

No display manager

Plasma can be started the old-fashioned way with startx, but extra care needs to be taken to ensure it gets a valid session.

FILE ~/.xinitrc
exec dbus-launch --exit-with-session startplasma-x11

When using Wayland, Plasma can be launched with dbus-launch --exit-with-session startplasma-wayland

This can be added to a user's profile file which will be executed when logging in:

FILE ~/.profile
dbus-launch --exit-with-session startplasma-wayland


Many useful widgets are in the kde-plasma/kdeplasma-addons package (already pulled in by kde-plasma/plasma-meta):

root #emerge --ask kde-plasma/kdeplasma-addons

System tray

Plasma 5 uses the StatusNotifier specification for systray icons [1]. As not all applications have been ported to the new system, some workarounds exist [2], and Plasma 5 has a means to convert old xembed-based system tray icons to StatusNotifier icons.

Legacy support is enabled by activating legacy-systray for kde-plasma/plasma-meta, which is pulling in kde-plasma/xembed-sni-proxy.

FILE /etc/portage/package.use/kde-plasma-settingsChange USE flags for kde-plasma/plasma-meta
# xembed system tray support for legacy applications
kde-plasma/plasma-meta legacy-systray


net-im/pidgin requires x11-plugins/pidgin-indicator. After install, the Ubuntu Indicator plugin can be found under Tools | Plugins.


Many users will be introduced to kde-frameworks/kwallet, Plasma's encrypted password storage, while adding a (wireless) network connection after login or adding E-Mail accounts in kde-apps/kmail.

For managing KWallets, importing and exporting passwords, there is kde-apps/kwalletmanager:

root #emerge --ask kde-apps/kwalletmanager

KWallet auto-unlocking

kde-plasma/kwallet-pam provides a mechanism to avoid being subsequently asked for access to kwallet after login.

root #emerge --ask kde-plasma/kwallet-pam

It requires the following setup:

  • For KWallet security, use classic blowfish encryption instead of GPG
  • Choose same password for login and kwallet
  • Configure a display manager with support for PAM - both x11-misc/sddm and x11-misc/lightdm fulfill that requirement:
FILE /etc/pam.d/sddmConfig lines for KWallet PAM unlocking via SDDM
-auth           optional        pam_kwallet5.so
-session        optional        pam_kwallet5.so auto_start
For LightDM, /etc/pam.d/lightdm needs to be edited instead.
If the filesystem containing a user's KWallet files is mounted by pam_mount upon logging on, it may be required to copy ~/.local/share/kwalletd/kdewallet.salt to the same path on the root filesystem. Otherwise, PAM attempts to unlock KWallet before the home directory is available and fails. The file ~/.local/share/kwalletd/kdewallet.kwl which actually contains the encrypted KWallet passwords does not need to be copied.

Disabling KWallet

To disable the KWallet subsystem completely, edit the following file:

FILE ~/.config/kwalletrc

SSH/GPG Agent startup/shutdown scripts

ssh-agent scripts are located in /etc/xdg/plasma-workspace/env and /etc/xdg/plasma-workspace/shutdown. Shutdown scripts require executable bit set because they are not sourced. The Keychain article provides more information about this.

Non-root user authentication for dialogs

Some KDE dialogs such as printers, adding wireless networks and adding users require administrator authentication. This is handled through sys-auth/polkit and operates independently from app-admin/sudo. By default in Gentoo, the root account is the only administrator, and so even if a user account can run root commands through sudo, authentication in these KDE dialogs will fail.

Adding wireless networks using net-misc/networkmanager is allowed by a polkit rule which is part of the Gentoo package and already allows access for every user in the group plugdev. For other dialogs the behavior must be configured manually: If all users of the group wheel are required to be administrators, create a copy of /etc/polkit-1/rules.d/50-default.rules starting with a number lower than 50, and edit the line return ["unix-user:0"] to the following:

FILE /etc/polkit-1/rules.d/49-wheel.rulesAdministrator wheel group
polkit.addAdminRule(function(action, subject) {
    return ["unix-group:wheel"];

The Polkit wiki page provides more details on rules configuration.

Run GUI applications with root privileges

It could be a very bad idea to start GUI applications with root privileges, versus adding the regular user to the relevant group or simply just running the command unprivileged. Only use kdesu when absolutely necessary.

KDE Plasma has a utility in order to start graphical programs with root privileges. It is provided by kde-plasma/kde-cli-tools - if built with USE flag kdesu, a graphical frontend to kde-frameworks/kdesu is installed. This requires Xorg, and only works within X[3].

FILE /etc/portage/package.use/kde-plasma-settingsChange USE flags for kde-plasma/kde-cli-tools
# Build graphical frontend for kde-frameworks/kdesu (requires X)
kde-plasma/kde-cli-tools kdesu X

Remember to rebuild the package to pick up the changes:

root #emerge -1 kde-cli-tools

It can be used by invoking kdesu either from KRunner or a terminal emulator:

user $kdesu <program-name>

A message dialog will be displayed prompting for the root password.

Some applications such as kwrite, dolphin etc. refuse to be opened with kdesu for security reasons.


XDG standard directories are being used for KDE Plasma and KDE applications:

  • $XDG_CONFIG_HOME (defaults to $HOME/.config) - Configuration files
  • $XDG_DATA_HOME (defaults to $HOME/.local/share) - Application data


The first step to remove KDE Plasma and its dependencies is to unmerge kde-plasma/plasma-meta. This will not yet remove any files from the installation, so the desktop environment will keep running:

root #emerge --ask --depclean --verbose kde-plasma/plasma-meta

In a next step it makes sense to scan /etc/portage directory for any KDE Plasma specific entries in package.mask, package.unmask and package.accept_keywords and clean them up.

Finally, run the command to uninstall any Plasma packages and their dependencies. It would make sense to quit any running Plasma session beforehand:

root #emerge --ask --depclean  
Please note that this will not just remove KDE Plasma but also any other package not registered (or being depended on) in @world. It makes sense to carefully read through the list of packages to be removed before continuing. Alternatively, run this command prior to unmerging of kde-plasma/plasma-meta to get an overview of already dangling packages on the system.


Release Service consists of various applications and supporting libraries based on Qt 5/KDE Frameworks 5.

Available versions

KDE Gentoo Ebuild repository Status
KDE Gear 22.08.3 kde-apps/kde-apps-meta-22.08.3 gentoo Stable for amd64, arm64, and x86; testing for ppc64
KDE Gear 22.12.3 kde-apps/kde-apps-meta-22.12.3 gentoo Testing for amd64, arm64, ppc64, and x86
KDE Gear 22.12 stable branch kde-apps/kde-apps-meta- KDE Live version
KDE Gear master branch kde-apps/kde-apps-meta-9999 KDE Live version

KDE Release Service is divided in the following meta packages:

Package name Description
kde-apps/kdeaccessibility-meta Accessibility applications and utilities.
kde-apps/kdeadmin-meta Administrative utilities, which helps in managing the system.
kde-apps/kdecore-meta Basic applications such as file browser, editor, terminal emulator.
kde-apps/kdeedu-meta Educational applications and games.
kde-apps/kdegames-meta Standard desktop games.
kde-apps/kdegraphics-meta Graphics applications such as image viewers, color pickers, etc.
kde-apps/kdemultimedia-meta Audio and video playback applications and services.
kde-apps/kdenetwork-meta Network applications and VNC services.
kde-apps/kdepim-meta PIM applications such as emailer, addressbook, organizer, etc.
kde-apps/kdesdk-meta Various development tools.
kde-apps/kdeutils-meta Standard desktop utilities such as a archiver, a calculator, etc.


The kde-apps/kde-apps-meta package provides the full Release Service bundle:

root #emerge --ask kde-apps/kde-apps-meta

If not all the packages are required, one or several smaller meta packages from the list above may be picked instead. Alternatively, it is possible to set USE flags to reduce the number of applications installed by kde-apps/kde-apps-meta.


Plasma-5 and Applications are shipping their localization per-package. Enable desired localization in systemsettings.


KDE PIM is a whole suite of applications to manage personal information including mail, calendar, contacts and more. It has several optional runtime dependencies to extend its functionality:


KDE Frameworks 5 is a collection of libraries and software frameworks that provide the foundation for KDE Plasma 5 and KDE Applications, but may be leveraged by any Qt application.

As Frameworks are mostly libraries and provide little user functionality, it's not necessary to install them manually - the required packages will be pulled in automatically as dependencies.

Available versions

KDE Gentoo Ebuild repository Status
KDE Frameworks 5.102.0 kde-frameworks/*-5.102.0 gentoo Stable for amd64, arm64, and x86; testing for arm, loong, ppc64 and riscv
KDE Frameworks 5.103.0 kde-frameworks/*-5.103.0 gentoo Testing for amd64, arm, arm64, loong, ppc64 riscv and x86
KDE Frameworks master branch kde-frameworks/*-9999 KDE Live version

More KDE software

The most important KDE applications are in the Gentoo ebuild repository and many are located in the kde-apps and kde-misc categories.


Refer to the Troubleshooting sub-article.

See also

External links