nix3-registry-pin(1)

📦
version 2.35.3 · 10 versions
, in fedora 44

🌸 nix3-registry-pin(1) 🌸

okay bestie, so this is nix registry pin — it lives in the General Commands Manual and it's here to make your flakes stay put. 💅

⚠️ Warning This program is experimental and its interface is subject to change. (yes girl, it can shift under you — read the warning, it's real)

✨ 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 metadata will say:

# nix flake metadata 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 🧚

So like, what this command does is add an entry to the user registry that maps the flake reference url to the corresponding locked flake reference — aka a flake reference that pins down an exact revision or content hash. 🔒 The way this hits: until you remove that registry entry, every single use of url resolves to exactly the same flake. no cap. every time. same flake. 🫶

Entries can be removed using nix registry remove. 👑

💅 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.
  • --arg-from-file name path — pass the contents of file path as the argument name to Nix functions.
  • --arg-from-stdin name — pass the contents of stdin as the argument name to Nix functions.
  • --argstr name string — pass the string string as the argument name to Nix functions.
  • --debugger — start an interactive environment if evaluation fails. 🐛 (lifesaver honestly)
  • --eval-store store-url — the URL of the Nix store to use for evaluation, i.e. to store derivations (.drv files) and inputs referenced by them.
  • --impure — allow access to mutable paths and repositories. 🙈
  • --include / -I path — add path to search path entries used to resolve lookup paths.

This option may be given multiple times. ✨

Paths added through -I take precedence over the nix-path configuration setting and the NIX_PATH environment variable.

  • --override-flake original-ref resolved-ref — override the flake registries, redirecting original-ref to resolved-ref.
  • --debug — set the logging verbosity level to ‘debug’.
  • --log-format format — set the format of log output; one of raw, internal-json, bar or bar-with-logs.
  • --print-build-logs / -L — print full build logs on standard error.
  • --quiet — decrease the logging verbosity level. 🤫
  • --verbose / -v — increase the logging verbosity level. 📢

💜 Miscellaneous global options 💜

  • --help — show usage information.
  • --offline — disable substituters and consider all previously downloaded files up-to-date.
  • --option name value — set the Nix configuration setting name to value (overriding nix.conf).
  • --refresh — consider all previously downloaded files out-of-date.
  • --repair — during evaluation, rewrite missing or corrupted files in the Nix store. During building, rebuild missing or corrupted store paths.
  • --version — show version information.
📝 Note See man nix.conf for overriding configuration settings with command line flags.

aaaand that's the whole thing bestie, you ate that 🍓💖 this lil page is nix3-registry-pin(1) from the General Commands Manual, and it signs off as nix3-registry-pin(1) too — same name top and bottom, main character energy fr fr. go pin something and slay ✨👑🦋

📦 where this page comes from