nix3-profile-upgrade(1)

📦
version 2.35.3 · 13 versions
, in fedora 44

💖 nix3-profile-upgrade(1) 💖

okay bestie, we're in the General Commands Manual and today's main character is nix profile upgrade — literally the glow-up button for your Nix profile 🫶

⚠️ Warning — this program is experimental and its interface is subject to change. (yes, it can and will switch up on you, no cap.)

✨ Name ✨

nix profile upgrade — upgrade packages using their most recent flake 🌸

🦋 Synopsis 🦋

nix profile upgrade [option…] elements…

🎀 Examples 🎀

  • Upgrade all packages that were installed using an unlocked flake reference:
# nix profile upgrade --all
  • Upgrade a specific package by name:
# nix profile upgrade hello
  • Upgrade all packages that include 'vim' in their name:
# nix profile upgrade --regex '.*vim.*'
  • Show what packages would be upgraded, without actually upgrading:
# nix profile upgrade --all --dry-run

💅 Description 💅

This command upgrades a previously installed package in a Nix profile, by fetching and evaluating the latest version of the flake from which the package was installed. it's giving "go get your fresh fit" 🔥

⚠️ Warning — this only works if you used an unlocked flake reference at installation time, e.g. nixpkgs#hello. It does not work if you used a locked flake reference (e.g. github:NixOS/nixpkgs/13d0c311e3ae923a00f734b43fd1d35b47d8943a#hello), since in that case the "latest version" is always the same. locked = the vibe is frozen in time, periodt 💀

🌈 Options 🌈

  • --all — match all packages in the profile. the whole squad 👑
  • --dry-run — show what this command would do without doing it. window shopping only, bestie 🛍️
  • --profile path — the profile to operate on.
  • --regex pattern — a regular expression to match one or more packages in the profile.

🧚 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 "call a friend" 😭)
  • --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. (old news, bestie, move on 💀)
  • --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'. (the tea is PIPING ☕)
  • --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.

🍓 Options that change the interpretation of installables 🍓

  • --expr expr — interpret installables as attribute paths relative to the Nix expression expr.
  • --file, -f file — interpret installables as attribute paths relative to the Nix expression stored in file. If file is the character -, then a Nix expression is read from standard input. Implies --impure.
Note — see man nix.conf for overriding configuration settings with command line flags.

and that's the whole page, bestie!! no skips, no shortcuts, all 40-ish options accounted for 💖 this was nix3-profile-upgrade(1) from the General Commands Manual — catching you in the group chat, mwah 🎀👑✨

📦 where this page comes from