Skip to Content
getting-started-4ve214fInstallation

Last Updated: 3/12/2026

Installation

Hyprland can be installed through your distribution’s package manager, Nix, or built from source. Choose the method that best fits your workflow.

Prerequisites

Before installing Hyprland, ensure your system meets these requirements:

  • Linux distribution with Wayland support
  • GPU with OpenGL ES 3.0 or higher
  • Graphics drivers: Mesa for AMD/Intel, proprietary drivers for NVIDIA
  • Development tools (for building from source): CMake, C++26 compiler, pkg-config

Installation Methods

NixOS / Nix Package Manager (Recommended)

Hyprland is available as a Nix flake. Add it to your NixOS configuration or home-manager:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    hyprland.url = "github:hyprwm/Hyprland";
  };
 
  outputs = { nixpkgs, hyprland, ... }: {
    nixosConfigurations.HOSTNAME = nixpkgs.lib.nixosSystem {
      modules = [
        hyprland.nixosModules.default
        {
          programs.hyprland.enable = true;
        }
      ];
    };
  };
}

For home-manager:

{
  home.packages = [ inputs.hyprland.packages.${pkgs.system}.hyprland ];
}

Build from Source

1. Install dependencies:

Hyprland requires these libraries (minimum versions from CMakeLists.txt):

  • aquamarine >= 0.9.3
  • hyprlang >= 0.6.7
  • hyprcursor >= 0.1.7
  • hyprutils >= 0.11.0
  • hyprgraphics >= 0.1.6
  • xkbcommon >= 1.11.0
  • wayland-server >= 1.22.91
  • wayland-protocols >= 1.45
  • libinput >= 1.28
  • cairo, pango, pangocairo, pixman-1, xcursor, libdrm, gbm, gio-2.0, re2, muparser, lcms2
  • hyprwayland-scanner >= 0.3.10
  • glslang (any version)

2. Clone and build:

git clone --recursive https://github.com/hyprwm/Hyprland
cd Hyprland
make release

3. Install:

sudo make install

The default install prefix is /usr/local. To change it:

make PREFIX=/usr release
sudo make PREFIX=/usr install

Distribution Packages

Check your distribution’s package manager. Hyprland may be available in:

  • Arch Linux: hyprland package in community repository
  • Gentoo: Available in overlays
  • Other distributions: Check your package manager or build from source

Post-Installation

After installation, you can:

  1. Launch from TTY: Simply run Hyprland in a TTY
  2. Launch from display manager: Select “Hyprland” from your login manager’s session list

Verifying Installation

Check that Hyprland is installed:

Hyprland --help

You should see command-line options including:

  • -h, --help: Show help
  • -c, --config: Specify config file
  • --socket: Set Wayland socket name
  • --wayland-fd: Set Wayland socket file descriptor

What’s Next

  • Quick Start: Configure and launch Hyprland for the first time
OverviewQuick Start