How to Install / Upgrade: Hyprland 0.55 announced the switch to Lua for its config files

Hyprland 0.55 was released by Vaxry on May 9, 2026, bringing changes across commits, contributors, and features. Configuration is now written in Lua, introducing a Layout API for user-defined custom layouts that can be applied globally, per-workspace, or per-monitor. Scrolling functionality has also been updated to support fullscreen windows as part of the tape by default, alongside a new native trackpad gesture.

To execute the upgrade to Hyprland 0.55, update your Hyprland installation to version 0.55 through your environment. Following the software update, begin migrating your setup from hyprlang to the new Lua configuration format. Consult the official wiki, which has been updated to provide instructions and documentation for the new Lua configs and Layout API.

For gotchas, existing hyprlang configuration files are not broken and will remain functional for a few releases. To verify the upgrade, ensure your existing hyprlang file or new Lua file loads correctly upon launch. Confirm verification by testing any user-defined layouts across your monitors or workspaces and checking scrolling behavior with fullscreen windows and native trackpad gestures.