nix3-flake-archive(1)

📦
version 2.35.3 · 12 versions
, in fedora 44

👑 nix3-flake-archive(1) 👑

okay so bestie, welcome to the General Commands Manual entry for nix flake archive, and lemme tell you, we're about to copy a whole flake and all its little input babies to a store 💖

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

✨ Name ✨

nix flake archive — copy a flake and all its inputs to a store 🫶🦋

🌸 Synopsis 🌸

nix flake archive [option…] flake-url

💅 Examples 💅

  • Copy the dwarffs flake and its dependencies to a binary cache:
# nix flake archive --to file:///tmp/my-cache dwarffs
  • Fetch the dwarffs flake and its dependencies to the local Nix store:
# nix flake archive dwarffs
  • Print the store paths of the flake sources of NixOps without fetching them:
# nix flake archive --json --dry-run nixops
  • Upload all flake inputs to a different machine for remote evaluation:
# nix flake archive --to ssh://some-machine

On the remote machine the flake can then be accessed via its store path. That's computed like this:

# nix flake metadata --json | jq -r '.path'

🎀 Description 🎀

Copy a flake and all its inputs to a store. This is useful i.e. to evaluate flakes on a different host. literally so handy when you're tryna vibe with a flake somewhere else 🧚✨

🌈 Options 🌈

  • --dry-run — Show what this command would do without doing it. window shopping, no cap 👀
  • --json — Produce output in JSON format, suitable for consumption by another program.
  • --no-check-sigs — Do not require that paths are signed by trusted keys.
  • --no-pretty — Print compact JSON output on a single line, even when the output is a terminal. Some commands may print multiple JSON objects on separate lines.
See --pretty.
  • --pretty — Print multi-line, indented JSON output for readability.
Default: indent if output is to a terminal. This option is only effective when --json is also specified.
  • --to store-uri — URI of the destination Nix store.

🌟 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. bestie gets a lil debugging hangout spot 😌
  • --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.
  • --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.
  • --no-update-lock-file — Do not allow any updates to the flake's lock file.
  • --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. This implies --no-write-lock-file.
  • --recreate-lock-file — Recreate the flake's lock file from scratch.
DEPRECATED — Use nix flake update instead.
  • --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.
  • --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. shhh 🤫
  • --verbose, -v — Increase the logging verbosity level. tell me EVERYTHING 💜

🎀 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.

and that's the whole page, babe 💖 no cap, you now officially know everything about nix3-flake-archive(1). this was giving General Commands Manual from nix3-flake-archive(1) energy the entire time, periodt. go archive a flake, main character 🌟👑💅

📦 where this page comes from