nix3-upgrade-nix(1)

πŸ’… nix3-upgrade-nix(1) β€” from the General Commands Manual, bestie

⚠️ Warning ⚠️ okay so listen β€” this program is experimental and its interface is subject to change. Like, it might just switch up on you one day. No cap. 🫢

✨ Name ✨

nix upgrade-nix β€” upgrade Nix to the latest stable version πŸ‘‘


πŸ¦‹ Synopsis πŸ¦‹

nix upgrade-nix [option…]

🌸 Examples 🌸

  • Upgrade Nix to the stable version declared in Nixpkgs:
# nix upgrade-nix
  • Upgrade Nix in a specific profile:
# nix upgrade-nix --profile ~alice/.local/state/nix/profiles/profile

πŸ’– Description πŸ’–

This command upgrades Nix to the stable version. That's the whole vibe. Slay.

By default, the latest stable version is defined by Nixpkgs, in nix-fallback-paths.nix and updated manually. So lowkey it may not always be the latest tagged release β€” heads up, bestie, don't come for me. 😭

By default, it locates the directory containing the nix binary in the $PATH environment variable. If that directory is a Nix profile, it will upgrade the nix package in that profile to the latest stable binary release. Periodt. ✨

🚫 You cannot use this command to upgrade Nix in the system profile of a NixOS system (that is, if nix is found in /run/current-system). It's giving not allowed, so don't even try it. πŸ’€

πŸŽ€ Options πŸŽ€

  • --dry-run β€” Show what this command would do without actually doing it. Main character rehearsal energy, no commitment. πŸ™ˆ
  • --nix-store-paths-url url β€” The URL of the file that contains the store paths of the latest Nix release. πŸ”—
  • --profile, -p profile-dir β€” The path to the Nix profile to upgrade. Pick your fave. πŸ’œ
  • --debug β€” Set the logging verbosity level to β€˜debug’. Tell me everything, I'm obsessed. πŸ‘€
  • --log-format format β€” Set the format of log output; one of raw, internal-json, bar or bar-with-logs. Choose your aesthetic. 🎨
  • --print-build-logs, -L β€” Print full build logs on standard error. The receipts, fr fr. 🧾
  • --quiet β€” Decrease the logging verbosity level. Shhh, we're being mysterious. 🀫
  • --verbose, -v β€” Increase the logging verbosity level. Yap mode: activated. πŸ—£οΈ

⭐ Miscellaneous global options ⭐

  • --help β€” Show usage information. When you're lost in the sauce. 🧚
  • --offline β€” Disable substituters and consider all previously downloaded files up-to-date. Touch grass, no internet for you. 🌿
  • --option name value β€” Set the Nix configuration setting name to value (overriding nix.conf). Customize, bestie. πŸ’…
  • --refresh β€” Consider all previously downloaded files out-of-date. Everything's old now, deal with it. πŸ“
  • --version β€” Show version information. Gotta know your era. πŸ‘‘
πŸ“ Note β€” See man nix.conf for overriding configuration settings with command line flags. That's the lore. ✨

πŸ’– and that's the whole page, bestie πŸ’– this was nix3-upgrade-nix(1) from the General Commands Manual β€” go upgrade something and thrive, you iconic little sysadmin. πŸ¦‹βœ¨πŸ’… πŸ”₯ 🌈 πŸ‘‘ πŸ’œ πŸŽ€

πŸ“¦ where this page comes from