Installation
Foreword
Due to their proprietary nature, Nvidia GPUs have limited compatibility with Hyprland. If you want to try Hyprland on Nvidia regardless (many people have reported successes), follow the Nvidia page after installing Hyprland.
Distros
Arch, NixOS and openSUSE Tumbleweed are very supported. For any other distro (not based on Arch/Nix) you might have varying amounts of success. However, since Hyprland is extremely bleeding-edge, distros like Pop!_OS, Ubuntu, etc. might have major issues running Hyprland.
Installation
Installing Hyprland is very easy. Simply install it with your package manager (if there is a Hyprland package available) or install/build it yourself.
yay -Syu --devel
, or your preferred package manager.Packages
WARNING: I do not maintain any packages. If they are broken, try building from source first.
Arch
hyprland-git (AUR) - compiles from latest source
hyprland - binary x86 tagged release
Nix
Enable Hyprland in your NixOS configuration:
programs.hyprland.enable = true;
For more details, read the Nix page.
openSUSE*
Hyprland is part of factory, starting with snapshot 20230411. To install it simply use zypper
sudo zypper in hyprland
or install the “hyprland” package via YaST2 Software.
Alternatively, you can also follow the instructions under “Manual (Manual Build)” to build Hyprland yourself.
Note: Hyprland is not available for Leap, as most libraries (and compiler) that Hyprland needs are too old.
Fedora*
On Fedora 39+, run:
sudo dnf install hyprland
sudo dnf install hyprland-devel # If you want to build plugins (use hyprpm)
Faster updates and additional packages are available in the solopasha/hyprland Copr repository.
If you are on an older version of Fedora, you can also compile it yourself by following the instructions here
Gentoo*
The hyprland package is available in the main tree:
emerge --ask gui-wm/hyprland
Additional packages like hyprlock, hypridle, xdg-desktop-portal-hyprland, hyprland-plugins, hyprpaper and hyprpicker are available in the GURU overlay. Community-contributed scripts are also available in GURU as part of the hyprland-contrib package.
eselect repository enable guru
emaint sync -r guru
emerge --ask gui-apps/hyprlock
emerge --ask gui-apps/hypridle
emerge --ask gui-libs/xdg-desktop-portal-hyprland
emerge --ask gui-apps/hyprland-plugins
emerge --ask gui-apps/hyprpaper
emerge --ask gui-apps/hyprpicker
emerge --ask gui-wm/hyprland-contrib
For USE flags and more details, read the Gentoo wiki page about Hyprland.
FreeBSD*
Hyprland and related are in the default repository:
Ubuntu 23.04*
Build Dependencies:
sudo apt-get install -y meson wget build-essential ninja-build cmake-extras cmake gettext gettext-base fontconfig libfontconfig-dev libffi-dev libxml2-dev libdrm-dev libxkbcommon-x11-dev libxkbregistry-dev libxkbcommon-dev libpixman-1-dev libudev-dev libseat-dev seatd libxcb-dri3-dev libegl-dev libgles2 libegl1-mesa-dev glslang-tools libinput-bin libinput-dev libxcb-composite0-dev libavutil-dev libavcodec-dev libavformat-dev libxcb-ewmh2 libxcb-ewmh-dev libxcb-present-dev libxcb-icccm4-dev libxcb-render-util0-dev libxcb-res0-dev libxcb-xinput-dev xdg-desktop-portal-wlr libtomlplusplus3
you will also need to build the latest wayland, wayland-protocols, and libdisplay-info tagged releases from source
for more info refer to the Ubuntu Guide For Installing And Building Hyprland Gist
Please note that since Ubuntu is generally behind with dependencies, it’s not guaranteed that the build process will work at all. Even if it is, it’s likely that it will break at some point in the future.
Refer to the gist if anything fails.
</div>
Void Linux*
Hyprland is not available from Void Linux’s official repositories due to a conflict of packaging philosophy. However, a third party repository is available with binary packages built in CI by GitHub Actions.
You can add this repository by creating a file such as /etc/xbps.d/hyprland-void.conf
with the following contents:
repository=https://raw.githubusercontent.com/Makrennel/hyprland-void/repository-x86_64-glibc
Then you can install the packages as you would any other:
sudo xbps-install -S hyprland
sudo xbps-install -S hyprland-devel # If you want to use plugins
sudo xbps-install -S xdg-desktop-portal-hyprland
xbps-query -Rs hypr # This will require you to have already accepted the repository's fingerprint using xbps-install -S
More information is available in the hyprland-void README, including information about how you can manually build Hyprland for Void Linux using the templates provided.
Slackware*
hyprland-bin (SlackBuilds) - Prebuilt release for Slackware ready for install
Hyprland is not installed by default on the current release of Slackware.
For detailed instructions on installing this build see here
* Unofficial, no official support is provided. These instructions are community-driven, and no guarantee is provided for their validity.
Manual (Releases, Linux-only)
Download the most recent release.
copy the binary (Hyprland) to /usr/bin/
.
copy hyprctl to /usr/bin/
.
copy hyprpm to /usr/bin/
.
copy the wlroots .so (libwlroots.so.XX032
) to /usr/lib/
.
copy the desktop entry (example/hyprland.desktop
) to /usr/share/wayland-sessions/
the example config is in example/hyprland.conf
.
For updating later on, you can overwrite the binaries (hyprctl, hyprland and libwlroots), you don’t need to update anything else.
Manual (Manual Build)
Dependencies:
Arch
yay -S gdb ninja gcc cmake meson libxcb xcb-proto xcb-util xcb-util-keysyms libxfixes libx11 libxcomposite xorg-xinput libxrender pixman wayland-protocols cairo pango seatd libxkbcommon xcb-util-wm xorg-xwayland libinput libliftoff libdisplay-info cpio tomlplusplus hyprlang hyprcursor hyprwayland-scanner xcb-util-errors
(Please make a pull request or open an issue if any packages are missing from the list)
OpenSuse
zypper in gcc-c++ git meson cmake "pkgconfig(cairo)" "pkgconfig(egl)" "pkgconfig(gbm)" "pkgconfig(gl)" "pkgconfig(glesv2)" "pkgconfig(libdrm)" "pkgconfig(libinput)" "pkgconfig(libseat)" "pkgconfig(libudev)" "pkgconfig(pango)" "pkgconfig(pangocairo)" "pkgconfig(pixman-1)" "pkgconfig(vulkan)" "pkgconfig(wayland-client)" "pkgconfig(wayland-protocols)" "pkgconfig(wayland-scanner)" "pkgconfig(wayland-server)" "pkgconfig(xcb)" "pkgconfig(xcb-icccm)" "pkgconfig(xcb-renderutil)" "pkgconfig(xkbcommon)" "pkgconfig(xwayland)" "pkgconfig(xcb-errors)" glslang-devel Mesa-libGLESv3-devel tomlplusplus-devel
(this should also work on RHEL/Fedora if you remove Mesa-libGLESv3-devel
and pkgconfig(xcb-errors)
)
FreeBSD
pkg install git pkgconf gmake gcc evdev-proto cmake wayland-protocols wayland libglvnd libxkbcommon libinput cairo pango pixman libxcb
pkg install meson jq `pkg rquery %dn wlroots` hwdata libdisplay-info libliftoff
export CC=gcc CXX=g++ LDFLAGS="-static-libstdc++ -static-libgcc"
Ubuntu
refer to the Ubuntu tab above
Please note Hyprland builds wlroots
. Make sure you have the dependencies of wlroots installed, you can make sure you have them by installing wlroots separately (Hyprland doesn’t mind)
Also note that Hyprland uses the C++23 standard, so both your compiler and your C++ library has to support that (gcc>=13.0.0
or clang>=15
). On Clang-based systems libc++ may be used by default, so until libc++ supports C++23 you have to pass -stdlib=libstdc++
or switch to GCC.
Additionally to those, you will also need a few hypr* dependencies which may or may not be packaged for your distro of choice:
- hyprlang
- hyprcursor
- hyprwayland-scanner (build-only)
CMake (recommended)
git clone --recursive https://github.com/hyprwm/Hyprland
cd Hyprland
make all && sudo make install
CMake is always recommended as it’s the intended way Hyprland should be installed.
Meson
meson subprojects update --reset
meson setup build
ninja -C build
ninja -C build install --tags runtime,man
Refer to Debugging to see how to build & debug.
Crash on launch
See Crashes and Bugs.
Custom installation (legacy renderer, etc)
cd into the hyprland repo.
for legacy renderer:
make legacyrenderer && sudo cp ./build/Hyprland /usr/bin && sudo cp ./example/hyprland.desktop /usr/share/wayland-sessions
please note the legacy renderer may not support some graphical features.
Any other config: (replace [PRESET] with your preset, release
debug
legacyrenderer
legacyrendererdebug
)
make [PRESET] && sudo cp ./build/Hyprland /usr/bin && sudo cp ./example/hyprland.desktop /usr/share/wayland-sessions
Custom Build flags
To apply custom build flags, you’ll have to ditch make.
Supported custom build flags:
NO_XWAYLAND - Removes XWayland support
NO_SYSTEMD - Removes systemd dependencies
How to?
Go to the root repo.
Then, configure CMake:
mkdir -p build && cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -D<YOUR_FLAG>:STRING=true -H./ -B./build -G Ninja
Change <YOUR_FLAG>
to one of the custom build flags. You are allowed to use multiple at once, then add another -D<YOUR_FLAG_2>:STRING=true
You can of course also change the BUILD_TYPE
to Debug
.
Now, build:
cmake --build ./build --config Release --target all -j $(nproc)
If you configured in Debug
, change the --config
to Debug
as well.
Now, of course, install manually.
sudo cp ./build/Hyprland /usr/bin && sudo cp ./example/hyprland.desktop /usr/share/wayland-sessions
Lastly, copy hyprctl, hyprpm, and wlroots as mentioned here
Running In a VM
YMMV, this is not officially supported.
Read through the libvirt Arch wiki page and get libvirt
, virsh
, and virt-viewer
setup and installed.
# Install libvirt and qemu things.
sudo pacman -S libvirt virt-viewer qemu-common
# Add yourself to the libvirt group.
sudo usermod -a -G libvirt USER # Replace 'USER' with your username.
# Enable and start libvirtd.
systemctl enable --now libvirtd
Go to the arch-boxes gitlab and download the latest arch qemu basic image. You can also download via any of arch’s mirrors.
curl https://geo.mirror.pkgbuild.com/images/latest/Arch-Linux-x86_64-basic.qcow2 \
-o ~/Downloads/arch-qemu.qcow2 # Or download wherever you want.
Create the VM with virsh.
# Use virt-install (included with libvirt) to install the vm from the image.
virt-install \
--graphics spice,listen=none,gl.enable=yes,rendernode=/dev/dri/renderD128 \
--name hypr-vm \
--os-variant archlinux \
--memory 2048 \
--disk ~/Downloads/arch-qemu.qcow2 \
--import
Connect with virt-viewer
, this will open a virt-viewer
graphical session on the tty. The default login is ‘arch’ for user and ‘arch’ for password.
virt-viewer --attach hypr-vm
Finally on the guest follow the instructions above for either installing hyprland-git from the aur or building manually.
mesa
as the OpenGL driver. The virgl drivers are included in mesa
.