lix-project/lix-releng-staging
0
0
Fork 0
Code Packages Activity
lix-releng-staging/src/nix/registry-pin.md
Alexander Bantyev 093ed47636
nix registry: add --registry flag
2021-06-30 22:13:32 +03:00

1.1 KiB
Raw Blame History

R""(

Examples

  • Pin nixpkgs to its most recent Git revision:

    # nix registry pin nixpkgs

    Afterwards the user registry will have an entry like this:

    nix registry list | grep '^user '
user   flake:nixpkgs github:NixOS/nixpkgs/925b70cd964ceaedee26fde9b19cc4c4f081196a

    and nix flake info will say:

    # nix flake info nixpkgs
Resolved URL:  github:NixOS/nixpkgs/925b70cd964ceaedee26fde9b19cc4c4f081196a
Locked URL:    github:NixOS/nixpkgs/925b70cd964ceaedee26fde9b19cc4c4f081196a
…

  • Pin nixpkgs in a custom registry to its most recent Git revision

    # nix registry pin --registry ./custom-flake-registry.json nixpkgs

Description

This command adds an entry to the user registry that maps flake reference url to the corresponding locked flake reference, that is, a flake reference that specifies an exact revision or content hash. This ensures that until this registry entry is removed, all uses of url will resolve to exactly the same flake.

Entries can be removed using nix registry remove.

)""