nix3-flake-clone(1)

📦
version 2.35.3 · 11 versions
, in fedora 44

💅 nix3-flake-clone(1) 💅

okay bestie, welcome to the nix3-flake-clone(1) manual page, we're doing this together 🫶

⚠️ Warning — this program is experimental and its interface is subject to change. fr fr, it might get a glow-up and change on you. 💀

✨ Name ✨

nix flake clone — clone flake repository 🧬✨

🌸 Synopsis 🌸

nix flake clone [option…] flake-url

🎀 Examples 🎀

okay so first up: check out the source code of the dwarffs flake and build it — iconic behaviour honestly:

# nix flake clone dwarffs --dest dwarffs
# cd dwarffs
# nix build

🦋 Description 🦋

so what this command does is: it performs a Git or Mercurial clone of the repository containing the source code of the flake flake-url. literally just yoink, gimme the source 💖 no cap.

✨ Options ✨

  • --dest, -f path — clone the flake to dest, that's the path bestie 🎯

🌈 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. it's giving we can fix this together 🫶
  • --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. chaos mode, lowkey.
  • --include, -I path — add path to search path entries used to resolve lookup paths.

This option may be given multiple times. 👑 (stack 'em, queen)

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. it's giving gaslight, gatekeep, girlboss but for refs 💅
  • --commit-lock-file — commit changes to the flake's lock file.
  • --inputs-from flake-url — use the inputs of the specified flake as registry entries.
  • --no-registries — don't allow lookups in the flake registries.
DEPRECATED — use --no-use-registries instead. this one's sooo 2023 bestie 😭
  • --no-update-lock-file — do not allow any updates to the flake's lock file. lock it down 🔒
  • --no-write-lock-file — do not write the flake's newly generated lock file.
  • --output-lock-file flake-lock-path — write the given lock file instead of flake.lock within the top-level flake.
  • --override-input input-path flake-url — override a specific flake input (e.g. dwarffs/nixpkgs). The input-path must not be empty — no empty input paths, we don't do that here 🚫. This implies --no-write-lock-file.
  • --recreate-lock-file — recreate the flake's lock file from scratch.
DEPRECATED — use nix flake update instead. respectfully, retire her 💀
  • --reference-lock-file flake-lock-path — read the given lock file instead of flake.lock within the top-level flake.
  • --update-input input-path — update a specific flake input (ignoring its previous entry in the lock file).
DEPRECATED — use nix flake update instead. okay girl we get it, move on 🌸
  • --debug — set the logging verbosity level to ‘debug’. spill the tea, all of it 🍵
  • --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. shhh 🤫
  • --verbose, -v — increase the logging verbosity level. louder 📣

⭐ Miscellaneous global options ⭐

  • --help — show usage information.
  • --offline — disable substituters and consider all previously downloaded files up-to-date. airplane mode aesthetic ✈️
  • --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. glow-up for your broken files 💅✨
  • --version — show version information.
📝 Note — see man nix.conf for overriding configuration settings with command line flags. iykyk 💖

and that's a wrap, bestie!! 🎀 you just read the whole nix3-flake-clone(1) page and honestly?? slay. go clone a flake, you've earned it. mwah 🫶💖

~ nix3-flake-clone(1) ~

📦 where this page comes from