Hyprland — плиточный композитор на базе Wayland, который стал популярен среди линуксоидов за гибкую настройку и анимации, которых не найти в стандартных окружениях. Но за красивыми скриншотами в интернете скрывается нюанс: это не GNOME и не KDE, установкой из одного пакета здесь не отделаться.
Прежде чем начать
Несколько важных моментов которые стоит знать до установки:
Только Wayland. Приложения рассчитанные исключительно на Xorg работать не будут или потребуют обёртку XWayland.
Nvidia — с ограничениями. Проприетарные драйверы Nvidia имеют частичную совместимость с Wayland-композиторами. Если у вас карта Nvidia — будьте готовы к дополнительным настройкам.
Виртуальные машины. Hyprland официально не поддерживает VM, но работает. В VirtualBox обязательно включить 3D-ускорение и выделить не менее 4 ГБ ОЗУ.
Ubuntu 24.10 — не брать. Да, начиная с Oracular Oriole Hyprland появился в стандартном репозитории Ubuntu. Но этот пакет пока нестабилен для постоянной работы.
Резервная копия. Перед установкой — бэкап важных данных.
SDDM не ставить. Установщик JaKooLit несовместим с SDDM, конфликт менеджеров дисплея сломает загрузку.
Шаг 1: включить репозиторий исходников
Установщику Hyprland потребуется доступ к исходным пакетам Ubuntu. Открыть «Программное обеспечение и обновления» → вкладка «Ubuntu Software» → поставить галочку напротив Source code → закрыть окно.
Шаг 2: обновить систему
После включения репозитория исходников — перезагрузиться и обновить систему до актуального состояния:
sudo apt update && sudo apt upgrade
Не пропускать этот шаг. Установщик Hyprland тянет свежие зависимости и конфликты со старыми пакетами — обычная причина сбоев в середине процесса.
Шаг 3: клонировать установщик
Ручная сборка Hyprland из исходников на Ubuntu — это лабиринт зависимостей и версионных конфликтов. Намного практичнее использовать установщик JaKooLit — проверенный автоматизированный скрипт для Ubuntu 24.04:
git clone -b 24.04 --depth 1 https://github.com/JaKooLit/Ubuntu-Hyprland.git ~/Ubuntu-Hyprland-24.04
Флаг -b 24.04 выбирает ветку именно для Ubuntu 24.04. Флаг --depth 1 клонирует только последний коммит без истории — быстрее и компактнее.
Шаг 4: дать права на выполнение
cd ~/Ubuntu-Hyprland-24.04
chmod +x install.sh
Шаг 5: запустить установщик
Важный момент — запускать не от root:
./install.sh
Установщик сразу предупреждает: максимальная совместимая версия Hyprland для Ubuntu 24.04 — v0.39.1. Это ограничение репозитория Ubuntu, а не самого установщика — версия wayland-protocols там отстаёт от требований новых релизов Hyprland.
Шаг 6: ответить на вопросы установщика
Скрипт задаёт вопросы о компонентах: нужны ли дополнительные темы, ставить ли Bluetooth-поддержку, устанавливать ли набор дотфайлов. На каждый вопрос ответить y или n.
Затем ввести пароль sudo — и дождаться завершения. Процесс занимает несколько минут в зависимости от скорости соединения.
Шаг 7: перезагрузиться и выбрать сессию
После завершения установки — перезагрузить систему:
reboot
На экране входа нажать на иконку шестерёнки и выбрать Hyprland из списка сессий.
Результат
После входа откроется рабочий стол Hyprland.
Если что-то пошло не так
Hyprland не запускается на VM. Проверить что в настройках VirtualBox включено 3D-ускорение — без него Wayland-сессия не стартует.
Чёрный экран после входа. Скорее всего конфликт с драйвером Nvidia. Для карт Nvidia потребуется дополнительная настройка переменных среды для Wayland — смотреть Hyprland Wiki раздел Nvidia.
Установщик упал в середине. Убедиться что обновление системы (шаг 2) прошло полностью и репозиторий исходников включён. Затем запустить ./install.sh повторно — скрипт можно перезапустить.
Нет звука / не работает буфер обмена. Это нормально при первом запуске — дотфайлы JaKooLit включают pipewire и wl-clipboard, но иногда требуется ручной запуск: systemctl --user start pipewire.
Шпаргалка
| Шаг | Действие |
|---|---|
| 1 | Включить Source code в Software & Updates |
| 2 | sudo apt update && sudo apt upgrade |
| 3 | git clone -b 24.04 --depth 1 https://github.com/JaKooLit/Ubuntu-Hyprland.git ~/Ubuntu-Hyprland-24.04 |
| 4 | cd ~/Ubuntu-Hyprland-24.04 && chmod +x install.sh |
| 5 | ./install.sh (не от root) |
| 6 | Ответить на вопросы установщика (y/n) |
| 7 | Перезагрузиться, выбрать сессию Hyprland |
