nix-super/src/nix/profile-upgrade.md

33 lines
756 B
Markdown
Raw Normal View History

2020-12-18 15:25:36 +02:00
R""(
# Examples
* Upgrade all packages that were installed using an unlocked flake
2020-12-18 15:25:36 +02:00
reference:
```console
# nix profile upgrade --regex '.*'
2020-12-18 15:25:36 +02:00
```
* Upgrade a specific package by name:
2020-12-18 15:25:36 +02:00
```console
# nix profile upgrade hello
2020-12-18 15:25:36 +02:00
```
# 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 an *unlocked* flake reference at
2020-12-18 15:25:36 +02:00
> installation time, e.g. `nixpkgs#hello`. It does not work if you
> used a *locked* flake reference
2020-12-18 15:25:36 +02:00
> (e.g. `github:NixOS/nixpkgs/13d0c311e3ae923a00f734b43fd1d35b47d8943a#hello`),
> since in that case the "latest version" is always the same.
)""