Vol(atile) NixOS — a stateless, flake-driven NixOS workstation

A declarative, performance-tuned, ephemeral NixOS configuration built on Nix Flakes and the Lix daemon. The root filesystem is a tmpfs wiped on every boot; all durable state is mapped onto /persist via impermanence. It adds a CachyOS low-latency kernel, UEFI Secure Boot (Lanzaboote), sops-nix secrets, isolated microvm.nix gateways, CUDA-accelerated local AI, and a bespoke Qt6/QML Hyprland desktop.

📖 Documentation

Full documentation lives at → volnixos-wiki.pgs.sh

Topic
Architecture	Boot, impermanence, kernel, secrets
Networking	Tor net-gate & Tailscale MicroVMs
Desktop	Hyprland, Quickshell, theming engine
Reference	Flake, Home Manager modules, dotfiles
Tooling	Makefile, Fish, agent toolchain
Limbo profile	Portable, generic-hardware install

The docs source is in docs/ (MkDocs Material). Preview locally with make docs-serve.

Quick start

git clone https://github.com/lowcache/volnixos.git ~/.nix-config
cd ~/.nix-config
make check          # nix flake check
make build          # build without switching
sudo make switch    # rebuild + switch (HOST=volnix)

Warning

The volnix host targets specific hardware (AMD Ryzen + hybrid AMD/NVIDIA GPU, ASUS laptop) and is published as a reference, not a turnkey install. For a clean build on standard x86_64 hardware, use the limbo profile.

Layout

.nix-config/
├── flake.nix          # inputs, overlays, hosts (volnix, limbo), VM runners
├── Makefile           # canonical operations interface (make help)
├── nixos/             # system modules + nixos/limbo (generic host)
├── home/              # Home Manager modules
├── dots/              # dotfiles (out-of-store symlinked to ~/.config)
├── scripts/           # agent toolchain (memd, tether, agent-scaffold)
├── docs/              # MkDocs Material documentation source
└── assets/            # banner / branding