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 a mutable flake reference:

       # nix profile upgrade '.*'

       • Upgrade a specific package:

       # nix profile upgrade packages.x86_64-linux.hello

       • Upgrade a specific profile element by number:

       # nix profile list
       0 flake:nixpkgs#legacyPackages.x86_64-linux.spotify …

       # nix profile upgrade 0

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.

              Warning

              This only works if you used a mutable flake reference at  installation  time,  e.g.
              nixpkgs#hello.  It  does  not  work  if you used an immutable flake reference (e.g.
              github:NixOS/nixpkgs/13d0c311e3ae923a00f734b43fd1d35b47d8943a#hello), since in that
              case the “latest version” is always the same.

Options

       • --profile path
         The profile to update.

       Common evaluation options:

       • --arg name expr
         Pass the value expr as the argument name to Nix functions.

       • --argstr name string
         Pass the string string as the argument name to Nix functions.

       • --eval-store store-url
         The Nix store to use for evaluations.

       • --impure
         Allow access to mutable paths and repositories.

       • --include / -I path
         Add path to the list of locations used to look up <...> file names.

       • --override-flake original-ref resolved-ref
         Override the flake registries, redirecting original-ref to resolved-ref.

       Common flake-related options:

       • --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. This option is deprecated; use --no-use-
         registries.

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

       • --override-input input-path flake-url
         Override a specific flake input (e.g. dwarffs/nixpkgs).  This  implies  --no-write-lock-
         file.

       • --recreate-lock-file
         Recreate the flake’s lock file from scratch.

       • --update-input input-path
         Update a specific flake input (ignoring its previous entry in the lock file).

       Options that change the interpretation of installables:

       • --derivation
         Operate on the store derivation rather than its outputs.

       • --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 will be read from standard input.

                                                                          nix3-profile-upgrade(1)