From b8c2962807911216eba17251539684e8c747354b Mon Sep 17 00:00:00 2001 From: Raito Bezarius Date: Tue, 30 May 2023 16:29:55 +0200 Subject: [PATCH] nixos/doc/manual/installation: update the upgrading chapter for 23.05 --- .../manual/installation/upgrading.chapter.md | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/nixos/doc/manual/installation/upgrading.chapter.md b/nixos/doc/manual/installation/upgrading.chapter.md index 26b6b8cc23ef..d39e1b786d83 100644 --- a/nixos/doc/manual/installation/upgrading.chapter.md +++ b/nixos/doc/manual/installation/upgrading.chapter.md @@ -6,7 +6,7 @@ expressions and associated binaries. The NixOS channels are updated automatically from NixOS's Git repository after certain tests have passed and all packages have been built. These channels are: -- *Stable channels*, such as [`nixos-22.11`](https://nixos.org/channels/nixos-22.11). +- *Stable channels*, such as [`nixos-23.05`](https://channels.nixos.org/nixos-23.05). These only get conservative bug fixes and package upgrades. For instance, a channel update may cause the Linux kernel on your system to be upgraded from 4.19.34 to 4.19.38 (a minor bug fix), but not @@ -14,13 +14,13 @@ passed and all packages have been built. These channels are: Stable channels are generally maintained until the next stable branch is created. -- The *unstable channel*, [`nixos-unstable`](https://nixos.org/channels/nixos-unstable). +- The *unstable channel*, [`nixos-unstable`](https://channels.nixos.org/nixos-unstable). This corresponds to NixOS's main development branch, and may thus see radical changes between channel updates. It's not recommended for production systems. -- *Small channels*, such as [`nixos-22.11-small`](https://nixos.org/channels/nixos-22.11-small) - or [`nixos-unstable-small`](https://nixos.org/channels/nixos-unstable-small). +- *Small channels*, such as [`nixos-23.05-small`](https://channels.nixos.org/nixos-23.05-small) + or [`nixos-unstable-small`](https://channels.nixos.org/nixos-unstable-small). These are identical to the stable and unstable channels described above, except that they contain fewer binary packages. This means they get updated faster than the regular channels (for instance, when a critical security patch @@ -28,7 +28,7 @@ passed and all packages have been built. These channels are: built from source than usual. They're mostly intended for server environments and as such contain few GUI applications. -To see what channels are available, go to . +To see what channels are available, go to . (Note that the URIs of the various channels redirect to a directory that contains the channel's latest version and includes ISO images and VirtualBox appliances.) Please note that during the release process, @@ -38,38 +38,38 @@ newest supported stable release. When you first install NixOS, you're automatically subscribed to the NixOS channel that corresponds to your installation source. For -instance, if you installed from a 22.11 ISO, you will be subscribed to -the `nixos-22.11` channel. To see which NixOS channel you're subscribed +instance, if you installed from a 23.05 ISO, you will be subscribed to +the `nixos-23.05` channel. To see which NixOS channel you're subscribed to, run the following as root: ```ShellSession # nix-channel --list | grep nixos -nixos https://nixos.org/channels/nixos-unstable +nixos https://channels.nixos.org/nixos-unstable ``` To switch to a different NixOS channel, do ```ShellSession -# nix-channel --add https://nixos.org/channels/channel-name nixos +# nix-channel --add https://channels.nixos.org/channel-name nixos ``` (Be sure to include the `nixos` parameter at the end.) For instance, to -use the NixOS 22.11 stable channel: +use the NixOS 23.05 stable channel: ```ShellSession -# nix-channel --add https://nixos.org/channels/nixos-22.11 nixos +# nix-channel --add https://channels.nixos.org/nixos-23.05 nixos ``` If you have a server, you may want to use the "small" channel instead: ```ShellSession -# nix-channel --add https://nixos.org/channels/nixos-22.11-small nixos +# nix-channel --add https://channels.nixos.org/nixos-23.05-small nixos ``` And if you want to live on the bleeding edge: ```ShellSession -# nix-channel --add https://nixos.org/channels/nixos-unstable nixos +# nix-channel --add https://channels.nixos.org/nixos-unstable nixos ``` You can then upgrade NixOS to the latest version in your chosen channel @@ -114,5 +114,5 @@ the new generation contains a different kernel, initrd or kernel modules. You can also specify a channel explicitly, e.g. ```nix -system.autoUpgrade.channel = https://nixos.org/channels/nixos-22.11; +system.autoUpgrade.channel = "https://channels.nixos.org/nixos-23.05"; ```