A modular, flake-based NixOS Stable configuration featuring an ephemeral root filesystem (impermanence), declarative disk partitioning (disko), pure-Nix Wayland desktop customization (Umbriel + Noctalia), post-quantum encrypted secrets (sops-nix), hardened networking, and gaming/virtualization optimizations.
| Host | Description | CPU / Kernel | GPU | Boot |
|---|---|---|---|---|
ultix-desktop |
Main Workstation | AMD Ryzen 7600X (Zen 4) · CachyOS Zen 4 LTO | AMD Radeon | Limine |
ultix-laptop |
TUXEDO Laptop | AMD Ryzen · XanMod | AMD Radeon + NVIDIA RTX (PRIME Offload) | Limine |
- Pure-Nix Desktop Customization: Entirely declarative configuration in
home/noctalia.nixfor Noctalia and Umbriel, dynamically rendering synchronized palettes across Umbriel, GTK3/GTK4 (adw-gtk3-dark), Qt/KDE (KColorScheme), and Konsole. - Display Manager: Noctalia Greeter (
greetd) configured inhosts/desktop-env.nixwith passwordless Noctalia appearance/wallpaper/monitor sync and AccountsService portrait integration. - Bootloader: Fast, lightweight Limine EFI bootloader (
sbctlSecure Boot capable on both hosts). - Typography & Cursors: JetBrainsMono Nerd Font, Noto Sans/Serif CJK JP, IPA/Kochi Japanese fonts, Noto Color Emoji, and
Bibata-Modern-Icecursors. - Integrated Toolkits: Cohesive dark-mode theming across native Wayland apps, GTK/libadwaita, Qt5/Qt6 (
kdeplatform theme), and Flatpak sandboxes.
- Wayland Compositor & Shell: Umbriel compositor paired with Noctalia bar, launcher, clipboard history, control center, OSDs, lockscreen, and automated wallpaper cycling.
- Window Management: Dynamic
dwindleandscrollinglayouts with per-workspace toggling, persistent workspaces1–9, sloppy focus-follows-mouse, Kawase blur, and direct-scanout rules for fullscreen andgamescopegames. - Portals & File Management: Hybrid XDG Desktop Portal routing (
umbriel+gtk+kde) pairing Umbriel screencasting with Dolphin (kio-extras,kio-fuse,kio-admin, thumbnailers) and standalone KDE XDG menus without pulling Plasma into the system closure. - Input Tuning:
us(altgr-intl) keyboard layout, flat mouse acceleration profile (1:1 tracking), and natural touchpad scrolling.
- Optimized Kernels: Zen 4 LTO CachyOS kernel (
linuxPackages_cachyos-lto-znver4from Chaotic-Nyx) onultix-desktopand XanMod (linuxPackages_xanmod) onultix-laptop. - Wine Synchronization:
ntsynckernel module enabled for low-overhead Wine/Proton thread synchronization. - System Tuning:
vm.max_map_count = 2147483642(SteamOS default), raisedinotifywatch/instance limits, and1048576nofilelimits across PAM and systemd. - Laptop & Hybrid Graphics: TUXEDO hardware support (
tuxedo-drivers,tuxedo-rs,tailor-gui) and open NVIDIA kernel modules with fine-grained power management and PRIME offload (nvidia-offload) onultix-laptop.
- Steam & Proton: Configured with 32-bit graphics, Steam Remote Play & dedicated server firewall rules, Gamescope session support, and declaratively materialized Proton runners (
Proton-CachyOS,Proton-GE). - Umbriel-Aware Gamescope (
gs-run): Custom launcher inhosts/gaming.nixthat auto-detects the focused Umbriel monitor's native resolution, refresh rate, HDR, and VRR state, with aspect clamping (16:9,21:9,4:3), FSR/pixel upscaling, Steam runtime isolation, andwineserverlifecycle tracking. - Bottles & Winetricks: Custom multi-arch FHS
bottles-winetrickshelper alongside Bottles pre-wired withgs-runandlsfg-vk. - Monitoring, GPU Control & Frame Generation: MangoHud, Goverlay, GameMode, LACT daemon/GUI for AMDGPU tuning, and Lossless Scaling Vulkan layer (
lsfg-vk).
- Post-Quantum Secrets (
sops-nix): SOPS-encrypted SSH, PGP, and API secrets unlocked via a persistent post-quantum hybrid Age master key (mlkem768x25519), with automatic GnuPG keyring import and enforced Git commit signing. - DNS-over-TLS & DNSSEC: Native
systemd-resolvedconfiguration enforcing DNS-over-TLS and DNSSEC with AdGuard DNS (dns.adguard-dns.com), backed by Quad9 (dns.quad9.net) and Mullvad (base.dns.mullvad.net) encrypted fallbacks. - Network Privacy & Firewall: NetworkManager configured with MAC address randomization (
stable-temporaryfor Wi-Fi/Ethernet and random Wi-Fi scan MACs), IPv6 privacy extensions (ip6-privacy = 2),nftablesfirewall, Windscribe VPN integration, andcaptive-browseronultix-laptop.
- Declarative Partitioning & Impermanence: Automated GPT partitioning, LUKS2 encryption, and Btrfs subvolumes (
@,@persist,@nix,@log,@snapshots,@swapwith a 32G swapfile) via Disko. An initrd systemd service wipes and recreates@(/) on every boot while system and user state are selectively persisted under/persist. - Containers: Coexisting rootful Docker and rootless Podman (with declarative
oci-containers, including anio_uring-enabled PostgreSQL 18 service bounded via systemd cgroups) plus local Kubernetes tooling. - Virtualization & Package Management: QEMU/KVM via
libvirtd(virt-manager,swtpmTPM emulation,virtiofsd, SPICE), Nix Flakes +nhautomatic generation cleanup, Home Manager, declarative Flatpaks vianix-flatpakwith daily auto-updates, andnix-ld+nix-alienfor running unpatched dynamic binaries.
<hostname> below is either ultix-desktop or ultix-laptop.
-
Boot into the NixOS Live USB.
-
Verify target disk ID: Ensure the disk ID in
hosts/desktop/disko.nixorhosts/laptop/disko.nixmatches your target drive:ls -l /dev/disk/by-id/
-
Partition, format, and mount with Disko:
sudo nix --extra-experimental-features "nix-command flakes" run github:nix-community/disko/latest -- --mode disko --flake github:fumoctl/Ultix#<hostname>
(Or clone the repo locally and use
--flake .#<hostname>) -
Initialize persistent user password: Because
users.mutableUsers = falseandhashedPasswordFile = "/persist/passwords/fumoctl"are enforced, you must seed the password hash into/persistbefore installing, or the account will be locked on first boot:sudo mkdir -p /mnt/persist/passwords nix-shell -p mkpasswd --run 'mkpasswd -m sha-512' | sudo tee /mnt/persist/passwords/fumoctl sudo chmod 600 /mnt/persist/passwords/fumoctl
-
(Optional) Restore SOPS Age master key: Restore your Age private key into
/persistbefore installing so SSH, PGP, and API secrets decrypt automatically on first boot:sudo mkdir -p /mnt/persist/sops sudo nano /mnt/persist/sops/fumosops.key # paste your AGE-SECRET-KEY-1... sudo chown -R 1000:1000 /mnt/persist/sops sudo chmod 700 /mnt/persist/sops sudo chmod 600 /mnt/persist/sops/fumosops.keyNote: If installing without this key, the system still builds and boots cleanly; secret decryption is skipped automatically.
-
Install NixOS:
sudo swapon /mnt/.swapvol/swapfile sudo mkdir -p /mnt/var/tmp/nix-build sudo TMPDIR=/mnt/var/tmp/nix-build nixos-install --flake github:fumoctl/Ultix#<hostname>
(Setting
TMPDIRon the mounted disk avoids out-of-memory errors in the Live USB's RAM-backed/tmpwhen building from source.) -
Reboot:
reboot
- Boot into the NixOS Live USB on the target machine.
- Generate hardware configuration (without storage mounts):
(The
nixos-generate-config --no-filesystems --show-hardware-config
--no-filesystemsflag avoids hardcoding mounts and UUIDs since Disko manages storage.) - Create the new host configuration:
- Create
hosts/<host>/:hardware-configuration.nix(paste the output from step 2).disko.nix(specify the target/dev/disk/by-id/...and Btrfs subvolume layout, including@persist).containers.nix(host-specific OCI container definitions).default.nix(import../common.nix,../containers.nix,./containers.nix,./hardware-configuration.nix, and./disko.nix, and setnetworking.hostName = "<hostname>";).
- Register
<hostname> = mkHost ./hosts/<host>;undernixosConfigurationsinflake.nix.
- Create
- Partition, seed credentials, and install:
sudo nix --extra-experimental-features "nix-command flakes" run github:nix-community/disko/latest -- --mode disko --flake .#<hostname> sudo mkdir -p /mnt/persist/passwords nix-shell -p mkpasswd --run 'mkpasswd -m sha-512' | sudo tee /mnt/persist/passwords/fumoctl sudo chmod 600 /mnt/persist/passwords/fumoctl sudo swapon /mnt/.swapvol/swapfile sudo mkdir -p /mnt/var/tmp/nix-build sudo TMPDIR=/mnt/var/tmp/nix-build nixos-install --flake .#<hostname> reboot
nh os switch
# Or explicitly with nixos-rebuild:
sudo nixos-rebuild switch --flake .#<hostname>nh os boot
# Or explicitly with nixos-rebuild:
sudo nixos-rebuild boot --flake .#<hostname>cd ~/Projects/Ultix
nix flake update
nh os switch