Skip to content

Installation Guide

Ekansh Bhavik edited this page Jan 6, 2026 · 3 revisions

Installation

This page provides a basic overview of installing Hyprland Rice. Detailed, distro-specific installation steps are available in separate pages.

If you are unsure which method to use, start here.


Before you begin

Make sure you have the following before starting:

  • A working internet connection
  • git installed
  • Basic familiarity with the terminal
  • A supported Linux distribution

For NixOS users, please read the NixOS installation guide before proceeding.


Quick installation (recommended)

For supported distributions, the easiest way to get started is using the interactive installer.

git clone https://github.com/realekansh/Hyprland-Rice.git
cd Hyprland-Rice
chmod +x install.sh
./install.sh

The installer will guide you through the process and ask for confirmation before installing packages or copying configuration files.


What the installer will do

  • Detect your Linux distribution
  • Install required Hyprland core components
  • Offer optional packages (bar, launcher, notifications, utilities, etc.)
  • Back up existing configuration files before copying new ones
  • Create a log file for reference and debugging

After installation

Once the installer finishes:

  • Log out of your current session
  • Select Hyprland from your display manager
  • Log in and verify everything works as expected

If something does not work as expected, check the log file and refer to the Logs, Errors, and Bugs page.


Distro-specific guides

For full, clear-cut installation steps, follow the guide for your distribution:


Manual installation

Advanced users may prefer to install packages and copy configuration files manually.

Manual installation steps are documented in the distro-specific guides. This approach is recommended if you want full control over every component.


Navigation

Clone this wiki locally