so embarrassing nix.desertthunder.dev
dotfiles docs src concepts flakes.md
1.5 kB · 42 lines
Markdown
at main

Flakes #

A flake is a pinned project interface. It declares inputs, records exact input revisions in flake.lock, and exposes outputs that commands can build or inspect.

Part Role
inputs.nixpkgs Main Nixpkgs channel for systems and packages.
inputs.nixpkgs-unstable Fast-moving packages, including Zed and AI agent CLIs.
inputs.home-manager User environment as part of each NixOS system.
inputs.sops-nix Secret material decrypted onto NixOS hosts.
outputs.nixosConfigurations Buildable NixOS hosts.

The important command target is:

.#nixosConfigurations.<hostname>

nixos-rebuild --flake .#<hostname> is shorthand for selecting one of those host outputs.

Lock File #

flake.lock is part of the system definition. Rebuilding without changing it uses the same upstream source graph. Updating it changes package and module inputs, so treat lock updates as intentional system changes.

Use targeted updates when possible:

nix flake lock --update-input nixpkgs-unstable

Use broad updates when the task is a full system refresh:

nix flake update

After changing inputs, evaluate or test one host before switching every host.