Skip to content

Repository files navigation

nixos-configs

Personal NixOS + Home Manager configuration, built with flake-parts. Not a generalist template.

Do not install this blindly

This config enables impermanence: /root is deleted and recreated from a blank snapshot on every boot. Anything not explicitly persisted is gone at the next reboot. Read the code before running any of it on a machine you care about.

Layout

flake.nix imports every .nix file under flake/modules/ via import-tree, rather than wiring paths together by hand. Each file declares one flake.modules.<class>.<name> module — <class> is nixos, homeManager, or darwin, so a single file can declare a NixOS module and a Home Manager module for the same feature side by side (nixd.nix installs the nixd LSP for both) instead of splitting one feature across two files that agree only by sharing a filename. Which category a module belongs to is decided by the directory it sits in, not by an explicit list, so moving a file between directories moves it between categories and nothing else has to change.

This keeps the config easy to reshape and hard to browse from a directory listing alone. flake/doc/dirsAsCategory.md explains that mechanism; flake/doc/flake-parts-rationale.md explains why flake-parts specifically, and what else of it this repo actually uses.

Hosts

  • nire-durandal — workstation
  • nire-tenacity — handheld, Jovian/SteamOS
  • nire-cube — workstation (GMKtec mini PC)

nire-durandal and nire-tenacity wipe /root on boot; nire-cube deliberately does not (see flake/modules/nireHost/cube-configuration.nix for why). nire-tenacity is currently the one this branch actually runs on; check CLAUDE.md's State section for the others' current status.

Secrets

sops-nix. secrets.yaml is encrypted and committed on purpose, not a mistake to fix.

Using this

Steal what's useful. Don't run nixos-rebuild switch against this as-is on a machine you are not prepared to lose /root on.

CLAUDE.md and wiki/lessons-learned.md are an AI agent's working notes, not documentation for a human reader — skip them unless you're the agent.

wiki/README.md is a topic index over the docs scattered around this repo (architecture, hosts, impermanence, conventions, open threads) — a better starting point than grepping if you're looking for a specific thing.

About

nixos configs

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages