mirror of
https://github.com/privatevoid-net/nix-super.git
synced 2024-11-10 00:08:07 +02:00
Improve documentation around upgrading nix (#9679)
* Improve documentation around upgrading nix, add replacing nix channel with new one Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
This commit is contained in:
parent
9651034dc2
commit
a4d33e816e
1 changed files with 35 additions and 0 deletions
|
@ -1,5 +1,40 @@
|
||||||
# Upgrading Nix
|
# Upgrading Nix
|
||||||
|
|
||||||
|
> **Note**
|
||||||
|
>
|
||||||
|
> These upgrade instructions apply for regular Linux distributions where Nix was installed following the [installation instructions in this manual](./index.md).
|
||||||
|
|
||||||
|
First, find the name of the current [channel](@docroot@/command-ref/nix-channel.md) through which Nix is distributed:
|
||||||
|
|
||||||
|
```console
|
||||||
|
$ nix-channel --list
|
||||||
|
```
|
||||||
|
|
||||||
|
By default this should return an entry for Nixpkgs:
|
||||||
|
|
||||||
|
```console
|
||||||
|
nixpkgs https://nixos.org/channels/nixpkgs-23.05
|
||||||
|
```
|
||||||
|
|
||||||
|
Check which Nix version will be installed:
|
||||||
|
|
||||||
|
```console
|
||||||
|
$ nix-shell -p nix -I nixpkgs=channel:nixpkgs-23.11 --run "nix --version"
|
||||||
|
nix (Nix) 2.18.1
|
||||||
|
```
|
||||||
|
|
||||||
|
> **Warning**
|
||||||
|
>
|
||||||
|
> Writing to the [local store](@docroot@/store/types/local-store.md) with a newer version of Nix, for example by building derivations with `nix-build` or `nix-store --realise`, may change the database schema!
|
||||||
|
> Reverting to an older version of Nix may therefore require purging the store database before it can be used.
|
||||||
|
|
||||||
|
Update the channel entry:
|
||||||
|
|
||||||
|
```console
|
||||||
|
$ nix-channel --remove nixpkgs
|
||||||
|
$ nix-channel --add https://nixos.org/channels/nixpkgs-23.11 nixpkgs
|
||||||
|
```
|
||||||
|
|
||||||
Multi-user Nix users on macOS can upgrade Nix by running: `sudo -i sh -c
|
Multi-user Nix users on macOS can upgrade Nix by running: `sudo -i sh -c
|
||||||
'nix-channel --update &&
|
'nix-channel --update &&
|
||||||
nix-env --install --attr nixpkgs.nix &&
|
nix-env --install --attr nixpkgs.nix &&
|
||||||
|
|
Loading…
Reference in a new issue