Official NixOS Wiki

KDE: Difference between revisions

← Older edit
Arch is the best (talk | contribs)
23 edits
VisualWikitext
Phobos (talk | contribs)
142 edits
mNo edit summary
Don't need ddcutil in system packages
 
(20 intermediate revisions by 6 users not shown)
Line 3: Line 3:
== Installation ==
== Installation ==


=== Plasma 6 ===
To use KDE Plasma, add this to your configuration.nix:


{{file|3=# Enable Plasma  
{{file|3={
services.desktopManager.plasma6.enable = true;
  # Enable Plasma  
  services.desktopManager.plasma6.enable = true;


# Default display manager for Plasma
  # Default display manager for Plasma
services.displayManager.sddm = {
  services.displayManager.sddm = {
  enable = true;
    enable = true;
    
    
# To use Wayland (Experimental for SDDM)
  # To use Wayland (Experimental for SDDM)
  wayland.enable = true;
    wayland.enable = true;
};
  };


# Optionally enable xserver
  # Optionally enable xserver
services.xserver.enable = true;|name=/etc/nixos/configuration.nix|lang=nix}}
  services.xserver.enable = true;
 
}|name=configuration.nix|lang=nix}}{{Warning|[[SDDM]] is no longer supported on the unstable branch, users on unstable should use [[Plasma Login Manager]] instead. See configuration options on the Plasma Login Manager page.}}
=== Plasma 5 ===
 
{{file|3=# Enable Plasma 5 and xserver
services.xserver = {
  enable = true;
  desktopManager.plasma5.enable = true;
};
 
# Enable the default display manager
services.displayManager.sddm.enable = true;|name=/etc/nixos/configuration.nix|lang=nix}}''<big>'''Note:'''</big> As of 2024, KDE Plasma 5 is end of life will not be available after NixOS 25.05.''


== Configuration ==
== Configuration ==
=== Rootless X11 ===
{{ic|sddm}} launches X11 as a root user by default. For better security, X11 can be run as a non-root user, but using Wayland is better tested and thus preferred:
<syntaxhighlight lang="nix">
# Using X11 as a non-root user
services.displayManager.sddm.settings.General.DisplayServer = "x11-user";
# Using Wayland (preferred)
services.displayManager.sddm.settings.General.DisplayServer = "wayland";
</syntaxhighlight>


=== Excluding applications from the default install ===
=== Excluding applications from the default install ===
Line 48: Line 27:
Some optional packages can be excluded if they are not needed at the cost of functionality.
Some optional packages can be excluded if they are not needed at the cost of functionality.


==== Plasma 6 ====
Optional packages: [https://github.com/NixOS/nixpkgs/blob/7e495b747b51f95ae15e74377c5ce1fe69c1765f/nixos/modules/services/desktop-managers/plasma6.nix#L150-L170]
 
Optional packages: [https://github.com/NixOS/nixpkgs/blob/nixos-24.11/nixos/modules/services/desktop-managers/plasma6.nix#L159-L174 plasma6.nix]


<syntaxHighlight lang=nix>
{{File|3={
environment.plasma6.excludePackages = with pkgs.kdePackages; [
  environment.plasma6.excludePackages = with pkgs.kdePackages; [
  plasma-browser-integration
    plasma-browser-integration
  konsole
    konsole
  elisa
    elisa
];
  ];
</syntaxHighlight>
}|name=configuration.nix|lang=nix}}
 
==== Plasma 5 ====
 
Optional packages: [https://github.com/NixOS/nixpkgs/blob/nixos-24.05/nixos/modules/services/x11/desktop-managers/plasma5.nix#L278-L282 plasma5.nix]
 
<syntaxHighlight lang=nix>
environment.plasma5.excludePackages = with pkgs.libsForQt5; [
  plasma-browser-integration
  konsole
  oxygen
];
</syntaxHighlight>


=== Default Wayland/X11 session ===
=== Default Wayland/X11 session ===


==== Plasma 6 ====
Plasma 6 runs on Wayland by default. To launch an X11 session by default:


Plasma 6 runs on Wayland by default. To launch an X11 session by default:
{{File|3={ 
  services.displayManager.defaultSession = "plasmax11";
}|name=configuration.nix|lang=nix}}


<syntaxhighlight lang="nix">
services.displayManager.defaultSession = "plasmax11";
</syntaxhighlight>


==== SDDM on Wayland ====
=== Unlock KDE Wallet with LUKS password ===


When using LUKS disk encryption and autologin in your display manager, it is possible to unlock KDE Wallet with the LUKS password. Set the LUKS password, login password, and KWallet keyring password all to the same string, and for NixOS 25.11 and below use the following configuration:
<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
services.displayManager.sddm.wayland.enable = true;
{
  boot.initrd.systemd.enable = true;
  systemd.services.display-manager.serviceConfig.KeyringMode = "inherit";
  security.pam.services.sddm-autologin.text = pkgs.lib.mkBefore ''
    auth optional ${pkgs.systemd}/lib/security/pam_systemd_loadkey.so
    auth include sddm
  '';
}
</syntaxhighlight>
</syntaxhighlight>


==== Plasma 5 ====
For Plasma Login Manager in NixOS 26.05 or above, use:
 
Plasma 5 runs on X11 by default and it is recommended to use Wayland with Plasma 6 instead. To launch a Wayland session by default anyway:
 
<syntaxhighlight lang="nix">
<syntaxhighlight lang="nix">
services.displayManager.defaultSession = "plasmawayland";
{
  boot.initrd.systemd.enable = true;
  systemd.services.plasmalogin.serviceConfig.KeyringMode = "inherit";
  security.pam.services.plasmalogin-autologin.rules.auth = {
    systemd_loadkey = {
      order = 0;
      control = "optional";
      modulePath = "${pkgs.systemd}/lib/security/pam_systemd_loadkey.so";
    };
    plasmalogin = {
      order = 1;
      control = "include";
      modulePath = "plasmalogin";
    };
  };
}
</syntaxhighlight>
</syntaxhighlight>


Line 140: Line 124:


=== Brightness and Color brightness control sets gamma instead of brightness on external monitors ===
=== Brightness and Color brightness control sets gamma instead of brightness on external monitors ===
To allow <code>powerdevil</code> (and by extension the "Brightness and Color" status tray menu) to control brightness on supported monitors directly instead of adjusting gamma, [[Backlight#Via ddcutil|configure your system to enable ddcutil]], and allow your user to use DDC/CI without root.
To allow <code>powerdevil</code> (and by extension the "Brightness and Color" status tray menu) to control brightness on supported monitors directly instead of adjusting gamma, [[Backlight#Via ddcutil|configure your system to enable ddcutil]], and allow your user to use DDC/CI without root. Note that you do not need to add <code>ddcutil</code> to your system packages because PowerDevil uses libddcutil.
 
=== Plasma wallpaper reverts back to default after a Nix GC ===
When setting a wallpaper, Plasma may save the path as a <code>/nix/store/*/share/wallpapers</code> path instead of <code>/run/current-system/sw/share/wallpapers/</code>. To fix this, open <code>$XDG_CONFIG_HOME/plasma-org.kde.plasma.desktop-appletsrc</code> and manually change the paths.
 
=== No available locale settings in the Plasma system settings ===
The "Region & Language" page in the Plasma system settings is somewhat broken on NixOS. Instead, edit the <code>$XDG_CONFIG_HOME/plasma-localerc</code> file.


== Tips and tricks ==
== Tips and tricks ==
Line 146: Line 136:
=== Plasma-Manager ===
=== Plasma-Manager ===


{{note|  [https://github.com/pjones/plasma-manager Plasma-Manager] is an unofficial community project and is not yet mature}}  
{{note|  [https://github.com/nix-community/plasma-manager Plasma-Manager] is a community project}}  
By default, the Plasma configuration can be handled like on [https://wiki.archlinux.org/title/KDE traditional systems].  
By default, the Plasma configuration can be handled like on [https://wiki.archlinux.org/title/KDE traditional systems].  
With [https://github.com/pjones/plasma-manager plasma-manager], it is possible to make Plasma configurations via nix by providing [https://github.com/nix-community/home-manager home-manager] modules.
With [https://github.com/nix-community/plasma-manager plasma-manager], it is possible to make Plasma configurations via nix by providing [https://github.com/nix-community/home-manager home-manager] modules.


=== User icon (avatar) ===
=== User icon (avatar) ===
Retrieved from "https://wiki.nixos.org/wiki/KDE"