Nix

Nix

To install Hyprland on NixOS, we provide a NixOS and a Home Manager module.

[!WARNING] Required:

  • NixOS Module: enables critical components needed to run Hyprland properly.
    Without this, you may have issues with missing session files in your Display Manager.

Optional:

  • Home Manager module: lets you configure Hyprland declaratively through Home Manager.
  • Configures Hyprland and adds it to your user’s $PATH, but does not make certain system-level changes such as adding a desktop session file for your display manager.
    This is handled by the NixOS module, once you enable it.

NixOS module

configuration.nix
{
  programs.hyprland.enable = true;
  # Optional, hint electron apps to use wayland:
  # environment.sessionVariables.NIXOS_OZONE_WL = "1";
}

For other NixOS options, see Hyprland on NixOS.
For additional options, see module options.

Home Manager module

Read Hyprland on Home Manager.

For the adventurous, @spikespaz has made a Hyprland module that can be used in Home Manager and NixOS. It can be found here.

Options and overrides

Read Options & Overrides.

Last updated on