git clone https://github.com/c4i0b/nixos-config.git ~/Projects/nixos-config
cd ~/Projects/nixos-config
nix flake lock                          # generate flake.lock on first use
sudo nixos-rebuild switch --flake .#<host>

Each host imports /etc/nixos/hardware-configuration.nix (machine-local, generated by nixos-generate-config); it is gitignored and not in this repo.

For a from-scratch install (partition, format, compression from byte 0), see ./fresh-deploy.md.

• NixOS Manual: https://nixos.org/manual/nixos/stable/
• Nixpkgs Manual: https://nixos.org/manual/nixpkgs/stable/
• Nix Manual: https://nixos.org/manual/nix/stable/
• NixOS Options: https://search.nixos.org/options
• Nixpkgs Packages: https://search.nixos.org/packages

• nixos-help - view NixOS manual offline
• man configuration.nix - configuration syntax reference
• nixos-option - inspect option values

• Channel status: https://status.nixos.org
• Channel branches: ./channel-branches.md

• Plymouth boot splash: ./plymouth.md
• Audio (PipeWire + kernel modprobe): ./audio.md

• https://wiki.nixos.org/

This config is flake-based. nixpkgs is pinned to nixos-26.05 and home-manager to release-26.05 (see flake.lock, which is committed).

nix flake update            # bump all inputs (review the diff, then rebuild)
nix flake update nixpkgs    # bump a single input
nix flake check             # validate the flake

To follow nixos-unstable instead of stable, change the inputs in flake.nix:

nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
home-manager.url = "github:nix-community/home-manager/master";