mccurdyc nixos-config

Inspiration

• MatthiasBenaets/nixos-config
  • For Mac
• cors/nixos-config
  • Shared modules
• ryan4yin/nix-config
  • Shared / re-usable modules for testing
  • https://nixos-and-flakes.thiscute.world/nixos-with-flakes/modularize-the-configuration
• mitchellh/nixos-config
  • Single lib/mkSystem.nix shared across nixos and nix-darwin
• phamann/nixos-config
• notusknot/dotfiles-nix
• kclejeune/system
• tfc/nixos-config
  • Nixcademy Nix Training

References

NixOS

• https://nixos.org/manual/nixos/stable/
• https://search.nixos.org/options
  • Searching configuration options
• https://nixos.org/manual/nixos/stable/options
  • Configuration options

Nixpkgs

• https://nixos.org/manual/nixpkgs/stable/
• https://search.nixos.org/packages

Nix-Darwin

• https://daiderd.com/nix-darwin/manual/index.html
  • Configuration options

Home-manager

• https://nix-community.github.io/home-manager/
  • Different section for standalone, nix-darwin and nixos.
  • Different section for ^^, but with flakes!
• https://nix-community.github.io/home-manager/options.html
  • Configuration options

Nix

• https://nixos.org/manual/nix/stable/

Other

• https://nix.dev/
• https://nixos.wiki/
• https://zero-to-nix.com/
• https://lazamar.co.uk/nix-versions/?channel=nixpkgs-unstable&package=terraform
  • Finding a nixpkgs hash for a binary version

Installation Docs

• nix-darwin
• nixos
• funix
• shared

Common Commands

faamac Rebuild

sudo darwin-rebuild switch --flake '.#faamac'

I've run into situations where I needed to clean old generations.

sudo nix-env --delete-generations old \
  --profile /nix/var/nix/profiles/system \
  && nix-collect-garbage -d

fgnix Rebuild

sudo nixos-rebuild switch --flake '.#fgnix'
# nixos-rebuild switch \
#   --flake 'github:mccurdyc/nixos-config#fgnix'

funix Rebuild

Standalone home-manager on an Ubuntu VM (not NixOS).

home-manager switch --flake '.#funix'

Update Flake

nix flake update --commit-lock-file

Formatting

nix fmt

Testing

Checks are exposed under checks.<system>.<name> and run by nix flake check.

Check	Kind	Systems
fgnix	NixOS VM test (boots the config, asserts nftables)	x86_64-linux
nuc	NixOS VM test (boots the config, asserts nftables)	x86_64-linux
funix	Eval-only (builds activationPackage)	x86_64-linux
faamac	Eval-only (builds darwin system drv)	aarch64-darwin

Eval all checks (no build, fast)

nix flake check --no-build

Run all checks (builds and executes VM tests)

nix flake check

Run a single check

nix build '.#checks.x86_64-linux.fgnix'
nix build '.#checks.x86_64-linux.nuc'
nix build '.#checks.x86_64-linux.funix'
nix build '.#checks.aarch64-darwin.faamac'  # on macOS only

Interactive debugging (drop into a running VM)

nix build '.#checks.x86_64-linux.fgnix.driver'
./result/bin/nixos-test-driver --interactive
(repl) fgnix.start()
(repl) fgnix.shell_interact()

Reference: https://blog.thalheim.io/2023/01/08/how-to-execute-nixos-tests-interactively-for-debugging/