Name

       nix registry pin - pin a flake to its current version or to the current version of a flake URL

Synopsis

       nix registry pin [option…] url locked

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 (./nix3-registry-remove.md).

Options

       • --registry registry
         The registry to operate on.

       Common evaluation options:

       • --arg name expr
         Pass the value expr as the argument name to Nix functions.

       • --argstr name string
         Pass the string string as the argument name to Nix functions.

       • --eval-store store-url
         The Nix store to use for evaluations.

       • --impure
         Allow access to mutable paths and repositories.

       • --include / -I path
         Add path to the list of locations used to look up <...> file names.

       • --override-flake original-ref resolved-ref
         Override the flake registries, redirecting original-ref to resolved-ref.

                                                                                            nix3-registry-pin(1)