Lord-Valen/configuration.nix
{ "createdAt": "2022-03-14T20:29:56Z", "defaultBranch": "main", "description": "Lordly NixOS Configurations", "fullName": "Lord-Valen/configuration.nix", "homepage": "", "language": "Nix", "name": "configuration.nix", "pushedAt": "2026-08-02T01:03:13Z", "stargazersCount": 29, "topics": [ "dendritic", "dendritic-nix", "dotfiles", "emacs", "home-manager", "nix-flake", "nixos", "nixos-config", "nixos-configuration", "nixos-dotfiles", "stylix" ], "updatedAt": "2026-08-02T01:03:16Z", "url": "https://github.com/Lord-Valen/configuration.nix"}How This README Is Generated[^modules-meta-files-readme-nix]
Section titled “How This README Is Generated[^modules-meta-files-readme-nix]”Each section is contributed by whichever module it documents,
via text.readme.parts.<name>,
and assembled in the order listed by text.readme.order.
For example, the Hosts section below comes from
[hosts.nix]!(modules/lib/options/hosts.nix), not this file -
each module documents itself next to its own definition
rather than everything living in one place.
Regenerate after editing any parts.* with:
write-files(available in the devshell).
Input Management[^modules-meta-inputs-nix]
Section titled “Input Management[^modules-meta-inputs-nix]”Inputs are pinned with nixtamal
and resolved with with-inputs.
There is no flake.lock;
pins live in [lock.json]!(nix/tamal/lock.json).
Entry points
Section titled “Entry points”| File | Purpose |
|---|---|
default.nix | Primary entry point; returns full flake outputs |
system.nix | Convenience entry point; selects the NixOS config for the current hostname (impure - reads /etc/hostname) |
flake.nix | Thin shim so flake-aware tools still work |
Switching
Section titled “Switching”nh os switch -f ./system.nixUpdating inputs
Section titled “Updating inputs”nixtamal refresh # refresh all non-frozen inputsnixtamal refresh <name> # refresh one inputnixtamal check-soundness # verify all fetches resolveHosts[^modules-lib-options-hosts-nix]
Section titled “Hosts[^modules-lib-options-hosts-nix]”The set of NixOS hosts is defined via an option which accepts deferred modules. Differentiating the hosts as a subset of the NixOS modules allows us to map over the hosts without string matching.
See usage at [autolycus]!(modules/hosts/autolycus/default.nix).
Closure Checks[^modules-lib-options-closureChecks-nix]
Section titled “Closure Checks[^modules-lib-options-closureChecks-nix]”Closure size checks are defined via the closureChecks option.
Each entry logs the human-readable closure size;
an optional budget field causes the check to fail if the size exceeds it.
See checks at [closureChecks/]!(modules/closureChecks/).
[^modules-meta-files-readme-nix] !: Written at [readme.nix]!(modules/meta/files/readme.nix).
[^modules-meta-inputs-nix] !: Written at [inputs.nix]!(modules/meta/inputs.nix).
[^modules-lib-options-hosts-nix] !: Written at [hosts.nix]!(modules/lib/options/hosts.nix).
[^modules-lib-options-closureChecks-nix] !: Written at [closureChecks.nix]!(modules/lib/options/closureChecks.nix).