-
Notifications
You must be signed in to change notification settings - Fork 0
Installation Guide ‐ NixOS
This page explains how to use Hyprland Rice on NixOS.
NixOS is fundamentally different from other Linux distributions.
Because of its declarative system design, the interactive installer
(install.sh) is not supported on NixOS.
Do not run install.sh on NixOS.
The installer is designed for imperative package managers (pacman, dnf, zypper) and may cause conflicts or unexpected behavior on NixOS.
Hyprland-Rice can still be used on NixOS, but setup must be done manually and declaratively.
- A working NixOS system
- Basic understanding of
configuration.nixor flakes - Hyprland enabled through NixOS modules
This guide assumes you already know how to rebuild your system safely
using nixos-rebuild.
Hyprland should be installed using the official NixOS modules.
Example (non-flake setup):
programs.hyprland.enable = true;
You may also need related services depending on your setup, such as PipeWire, portals, and seat management.
Refer to the official NixOS and Hyprland documentation for the most up-to-date module options.
Hyprland-Rice provides configuration files that can be reused on NixOS. However, they should be copied manually.
Recommended approach:
- Clone the repository
- Review configuration files inside
config/ - Copy only what you understand into
~/.config
Do not blindly overwrite existing configuration files. NixOS users are encouraged to adapt configs gradually.
Wallpapers provided in this repository can be used safely on NixOS.
You may:
- Copy wallpapers from
assets/wallpapers - Reference them from your Hyprland configuration
- Manage them declaratively or imperatively as you prefer
Tools such as status bars, launchers, and notification daemons must be installed through NixOS packages.
Examples include:
- Waybar
- Notification daemons (e.g., mako)
- Launchers (rofi, alternatives)
Refer to NixOS package definitions and modules for correct usage.
If something does not work as expected:
- Check your system rebuild logs
- Verify Hyprland is launching correctly
- Ensure required services are enabled declaratively
Avoid mixing imperative system changes with declarative configuration.