templates/nixos-hyprland
Template
1
Fork 0
Code Activity
nixos-hyprland/README.md
Leonardo Devai 5007aee423 Review and modernize all 42 projects to the updated standard 
Pinned 2026 toolchains (Go 1.26, Rust 1.98/edition 2024, Python 3.14 + uv, Node 24,
Zig 0.16, NixOS 26.05), postgres 18 / mongo 8, lockfiles built from, non-root
runtimes, .dockerignore, per-project LICENSE, READMEs with the git.devai.io clone
line, checkout@v7 CI. Security fixes in the legacy Rust APIs (any-password login,
self-assigned admin, hard-coded JWT secret), JWT alg/exp/sub enforcement across the
blog series, safe markdown links in the frontends, and many smaller bugs — every
project was built, run and exercised end to end.

Adds scripts/publish.sh + a CI publish job that splits every folder into its own
repo at git.devai.io/templates/<folder>.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01128fhuZbgivaSJvtMf4s1G
2026-09-27 21:10:38 +02:00

3.4 KiB
Raw Permalink Blame History

nixos-hyprland

A minimal-but-real NixOS 26.05 desktop flake for Hyprland: greetd + tuigreet login, PipeWire audio, portals/polkit/keyring wired for Wayland, and a home-manager config with sensible keybinds, waybar, kitty, wofi and mako.

Run

On a UEFI machine (or VM) running NixOS — the minimal ISO install is enough:

sudo nix-shell -p git --run 'git clone https://git.devai.io/templates/nixos-hyprland.git /etc/nixos-hyprland'
cd /etc/nixos-hyprland
# 1. Replace the stub hardware config with the one for THIS machine
sudo nixos-generate-config --show-hardware-config | sudo tee hosts/desktop/hardware-configuration.nix >/dev/null
# 2. Rename the user and host (below), then build and switch
sudo nixos-rebuild switch --flake .#desktop

Reboot and log in via tuigreet as user with the initial password changeme — run passwd right away. tuigreet launches Hyprland via start-hyprland; first things to try: Super+Return (terminal), Super+Space (launcher), Super+1..9 (workspaces), Super+Q (close), Print (region screenshot to clipboard). nixos-rebuild turns flakes on for its own run; the config enables them permanently.

How it works

hosts/desktop/hardware-configuration.nix is a stub: it only exists so the flake evaluates out of the box and will not boot real hardware. Step 1 above replaces it with the file generated for your disks and CPU — the one file that is yours, not the template's.

The placeholders are user and desktop. Rename them in three places:

  • flake.nix — home-manager.users.user and (if you like) the nixosConfigurations.desktop attribute name
  • hosts/desktop/configuration.nix — users.users.user and networking.hostName
  • home/user.nix — home.username, home.homeDirectory, git identity

Notes:

  • Hyprland comes from nixpkgs (binary-cached), not the upstream flake — updates arrive with nix flake update. programs.hyprland installs it system-wide; home-manager only writes its config.
  • flake.lock pins nixpkgs and home-manager; nix flake update moves both to the latest 26.05 commits. For the next release, change nixos-26.05 and release-26.05 in flake.nix together.
  • system.stateVersion / home.stateVersion mark the release you first installed; leave them alone when upgrading.

Layout

flake.nix                              nixpkgs nixos-26.05 + home-manager release-26.05
flake.lock                             the exact commits of both
hosts/desktop/configuration.nix        boot, network, audio, greetd, Hyprland, fonts, user
hosts/desktop/hardware-configuration.nix   STUB — replace via nixos-generate-config
home/user.nix                          Hyprland keybinds, waybar, kitty, wofi, mako, git

Deploy

sudo nixos-rebuild switch --flake .#desktop is the deploy: run it after every change. Push to your own GitHub repo and the shipped workflow (.github/workflows/ci.yml) evaluates the whole system on every push and pull request — nix flake check plus the system derivation, nothing is built — inside the official nixos/nix image.

Part of devai.io — the NixOS desktop series: nixos-hyprland, nixos-gnome, nixos-plasma.