NixOS Configuration

Personal flake managing two NixOS hosts (ninja, windy) and a nix-darwin Mac. Tracks nixos-26.05 stable. Custom packages live in a separate nix-packages repo consumed as a flake input.

Overview

• OS: NixOS 26.05 (stable) + nix-darwin 26.05 (Mac)
• DM: noctalia-greeter (greetd) with YubiKey U2F
• Compositor: Niri (scrollable-tiling Wayland) via niri-flake
• Shell of the desktop: Noctalia v5 (bar, launcher, notifications, control center, lock, OSDs, clipboard, session panel). Native Wayland + OpenGL ES, no Qt or GTK.
• File manager: Nemo (+ file-roller, ffmpegthumbnailer)
• Theme: App colors are Catppuccin Mocha Blue, system-wide via Stylix; the Noctalia shell palette is generated from the current wallpaper
• Shell: Zsh + Starship + Atuin + Zoxide (all hosts, Mac included)
• Terminal: Kitty + tmux
• Editor: LazyVim (Neovim distribution)
• Security: dbus-broker, sops-nix + age, YubiKey (U2F), pinned binary caches
• Gaming: Steam (NVIDIA Optimized), Lutris, Bottles, GameMode, sched-ext
• Kernel (ninja): nixpkgs linux_latest built with -march=native (X86_NATIVE_CPU) + 1000Hz, see hosts/ninja/kernel.nix

Structure

flake.nix          # Entry point: defines inputs, hosts, devShells, checks
lib/               # mkSystem helper, user config
hosts/             # Per-host configuration.nix + hardware
modules/           # Reusable NixOS modules (mySystem.* options)
  core/            # Audio, codecs, nix-ld, performance, sops, maintenance
  desktop/         # Niri compositor, noctalia-greeter, NVIDIA glue
  gaming/          # Steam, GameMode, sched-ext (SCX)
home/              # Home Manager modules (per-app .nix files)
  niri.nix         # Compositor config, keybinds, spawn-at-startup
  noctalia.nix     # Noctalia shell (bar, launcher, notifications, lock)
  shell/           # Split shell config (aliases, functions, packages)
users/             # Per-user profile composition
overlays/          # Package overrides
secrets.yaml       # SOPS-encrypted secrets
docs/              # Human-readable documentation

Custom packages live in nix-packages and are consumed as a flake input. Use nix-init to bootstrap new package definitions.

Documentation

• Hardware (ninja) | Hardware (windy)
• NVIDIA Driver Updates
• Security & Hardening | Secrets
• Disaster Recovery & Disko
• CLI Tools | Just Commands
• Niri Keybindings & UX
• LazyVim (Neovim)
• Full Index

Quick Start

To apply changes and switch to the new configuration:

# Using nh (recommended)
nh os switch .

# Standard Nix
sudo nixos-rebuild switch --flake .

# Update all flake inputs
nix flake update

# Clean old generations
nh clean all