nixpkgs/pkgs/tools/package-management/nix
2024-10-13 19:36:25 +02:00
..
patches nixVersions.git: 2.25.0pre20240910 -> 2.25.0pre20240920 2024-09-20 14:40:59 +08:00
common.nix treewide: use lowdown-unsandboxed where appropriate 2024-10-07 04:26:56 +01:00
default.nix nixVersions.nix_2_24: 2.24.8 -> 2.24.9 (#348038) 2024-10-13 19:36:25 +02:00
nix-perl.nix treewide: replace stdenv.is with stdenv.hostPlatform.is 2024-09-25 00:04:37 +03:00
README.md nix: add upgrade guide for bumping nix versions 2024-09-22 18:08:47 +02:00

Steps for Testing New Releases

Patch Releases or Updating nixVersions.{latest,git}

Branch to merge into: master or release-$nixos-version

Build the affected Nix packages and run their tests on the following platforms: x86_64-linux, aarch64-linux, x86_64-darwin, and aarch64-darwin. If you lack the necessary hardware for these platforms, you may need to ask others for assistance with the builds. Alternatively, you can request access to the Nix community builder for all platforms here and here.

To build all dependent packages, use:

nix-review pr <your-pull-request>

And to build all important NixOS tests, run:

# Replace $version with the actual Nix version
nix-build nixVersions.nix_$version.tests

Be sure to also update the nix-fallback-paths whenever you do a patch release for nixVersions.stable

# Replace $version with the actual Nix version
curl https://releases.nixos.org/nix/nix-$version/fallback-paths.nix > nixos/modules/installer/tools/nix-fallback-paths.nix

Major Version Bumps

If you're updating nixVersions.stable, follow all the steps mentioned above, but use the staging branch for your pull request (or staging-next after coordinating with the people in matrix #staging:nixos.org) This is necessary because, at the end of the staging-next cycle, the NixOS tests are built through the staging-next-small jobset. Especially nixos installer test are important to look at here.