View source for KDE Plasma

#REDIRECT [[KDE]]KDE Plasma is a fast, customizable [[:Category:Desktop environment|desktop environment]] designed to be simple by default but powerful when needed. <ref>Official KDE Plasma promotional material https://kde.org/plasma-desktop/</ref>

== Installation ==

=== Plasma Desktop ===
To install the Plasma desktop environment on NixOS, the following options should be added to your configuration.nix (or [[Flakes|flake.nix]] if you so desire).
{{File|3={ config, pkgs, ... }:
{

  # SDDM Display Manager
  services.displayManager.sddm.enable = true;

  # Plasma 5 (*deprecated* - unavailable after 25.05)
  services.xserver.desktopManager.plasma5.enable = true;

  # Plasma 6
  services.desktopManager.plasma6.enable = true;

  # Exclude certain default applications from being installed
  environment.plasma6.excludePackages = with pkgs; [ kdePackages.<package> ]; 

}|name=/etc/nixos/configuration.nix|lang=nix}}

== Configuration ==
All configuration of KDE Plasma should be done through the built in settings application. There are very few options in the NixOS module. 
A small number of Plasma extensions and themes have been packaged in Nixpkgs for convenience and can be added in the usual way packages are installed. These can be found in the [https://github.com/NixOS/nixpkgs/tree/nixos-unstable/pkgs/kde/third-party Nixpkgs repo] or by using [https://search.nixos.org/packages?channel=unstable&query=kdePackages+theme search.nixos.org].
If you plan to use Qt 5 applications on Plasma 6, you should enable the Qt 5 integration. This allows theming to be more cohesive across Qt5 and Qt6 applications.<syntaxhighlight lang="nixos">
services.desktopManager.plasma6.enableQt5Integration = true;

</syntaxhighlight>

== SDDM Configuration ==
Configuration of the SDDM login manager is done in the usual way through the NixOS module. 

==== Example Configuration ====
{{File|3={config, pkgs, ... }:
{
<...>
  services.displayManager.sddm = {
    enable = true;
    theme = "breeze";
    wayland.enable = true;
    enableHidpi = true;
    settings = {
      Autologin = {
        Session = "plasma.desktop";
        User = "john";
      };
    };
  };
<...>
}|name=/etc/nixos/configuration.nix|lang=nix}}
Any options not directly configurable in the NixOS module can be passed to SDDM via: <syntaxhighlight lang="nixos">
services.displayManager.sddm.settings = { <...> };
</syntaxhighlight>

== References ==