···

       
22
       
22
       
 
       
  - made sure NixOS tests are [linked](https://nixos.org/manual/nixpkgs/unstable/#ssec-nixos-tests-linking) to the relevant packages

     

       
23
       
23
       
 
       
- [ ] Tested compilation of all packages that depend on this change using `nix-shell -p nixpkgs-review --run "nixpkgs-review rev HEAD"`. Note: all changes have to be committed, also see [nixpkgs-review usage](https://github.com/Mic92/nixpkgs-review#usage)

     

       
24
       
24
       
 
       
- [ ] Tested basic functionality of all binary files (usually in `./result/bin/`)

     

       
25
       
25
       
-
       
- [22.05 Release Notes (or backporting 21.11 Release notes)](https://github.com/NixOS/nixpkgs/blob/master/CONTRIBUTING.md#generating-2205-release-notes)

     

       
25
       
25
       
+
       
- [22.11 Release Notes (or backporting 21.11 Release notes)](https://github.com/NixOS/nixpkgs/blob/master/CONTRIBUTING.md#generating-2211-release-notes)

     

       
26
       
26
       
 
       
  - [ ] (Package updates) Added a release notes entry if the change is major or breaking

     

       
27
       
27
       
 
       
  - [ ] (Module updates) Added a release notes entry if the change is significant

     

       
28
       
28
       
 
       
  - [ ] (Module addition) Added a release notes entry if adding a new NixOS module

     

···

       
119
       
119
       
 
       
- Services which require a client to be up-to-date regardless. (E.g. `spotify`, `steam`, or `discord`)

     

       
120
       
120
       
 
       
- Security critical applications (E.g. `firefox`)

     

       
121
       
121
       
 
       


     

       
122
       
122
       
-
       
## Generating 22.05 Release Notes

     

       
123
       
123
       
-
       


     

       
124
       
124
       
-
       
(This section also applies to backporting 21.11 release notes: substitute "rl-2205" for "rl-2111".)

     

       
122
       
122
       
+
       
## Generating 22.11 Release Notes

     

       
125
       
123
       
 
       


     

       
126
       
124
       
 
       
Documentation in nixpkgs is transitioning to a markdown-centric workflow. Release notes now require a translation step to convert from markdown to a compatible docbook document.

     

       
127
       
125
       
 
       


     

       
128
       
128
       
-
       
Steps for updating 22.05 Release notes:

     

       
126
       
126
       
+
       
Steps for updating 22.11 Release notes:

     

       
129
       
127
       
 
       


     

       
130
       
130
       
-
       
1. Edit `nixos/doc/manual/release-notes/rl-2205.section.md` with the desired changes

     

       
131
       
131
       
-
       
2. Run `./nixos/doc/manual/md-to-db.sh` to render `nixos/doc/manual/from_md/release-notes/rl-2205.section.xml`

     

       
132
       
132
       
-
       
3. Include changes to `rl-2205.section.md` and `rl-2205.section.xml` in the same commit.

     

       
128
       
128
       
+
       
1. Edit `nixos/doc/manual/release-notes/rl-2211.section.md` with the desired changes

     

       
129
       
129
       
+
       
2. Run `./nixos/doc/manual/md-to-db.sh` to render `nixos/doc/manual/from_md/release-notes/rl-2211.section.xml`

     

       
130
       
130
       
+
       
3. Include changes to `rl-2211.section.md` and `rl-2211.section.xml` in the same commit.

     

       
133
       
131
       
 
       


     

       
134
       
132
       
 
       
## Reviewing contributions

     

       
135
       
133
       
 
       


     

···

       
12
       
12
       
 
       
    <listitem>

     

       
13
       
13
       
 
       
      <para>

     

       
14
       
14
       
 
       
        <emphasis>Stable channels</emphasis>, such as

     

       
15
       
15
       
-
       
        <link xlink:href="https://nixos.org/channels/nixos-21.11"><literal>nixos-21.11</literal></link>.

     

       
15
       
15
       
+
       
        <link xlink:href="https://nixos.org/channels/nixos-22.05"><literal>nixos-22.05</literal></link>.

     

       
16
       
16
       
 
       
        These only get conservative bug fixes and package upgrades. For

     

       
17
       
17
       
 
       
        instance, a channel update may cause the Linux kernel on your

     

       
18
       
18
       
 
       
        system to be upgraded from 4.19.34 to 4.19.38 (a minor bug fix),

     
···

       
33
       
33
       
 
       
    <listitem>

     

       
34
       
34
       
 
       
      <para>

     

       
35
       
35
       
 
       
        <emphasis>Small channels</emphasis>, such as

     

       
36
       
36
       
-
       
        <link xlink:href="https://nixos.org/channels/nixos-21.11-small"><literal>nixos-21.11-small</literal></link>

     

       
36
       
36
       
+
       
        <link xlink:href="https://nixos.org/channels/nixos-22.05-small"><literal>nixos-22.05-small</literal></link>

     

       
37
       
37
       
 
       
        or

     

       
38
       
38
       
 
       
        <link xlink:href="https://nixos.org/channels/nixos-unstable-small"><literal>nixos-unstable-small</literal></link>.

     

       
39
       
39
       
 
       
        These are identical to the stable and unstable channels

     
···

       
60
       
60
       
 
       
  <para>

     

       
61
       
61
       
 
       
    When you first install NixOS, you’re automatically subscribed to the

     

       
62
       
62
       
 
       
    NixOS channel that corresponds to your installation source. For

     

       
63
       
63
       
-
       
    instance, if you installed from a 21.11 ISO, you will be subscribed

     

       
64
       
64
       
-
       
    to the <literal>nixos-21.11</literal> channel. To see which NixOS

     

       
63
       
63
       
+
       
    instance, if you installed from a 22.05 ISO, you will be subscribed

     

       
64
       
64
       
+
       
    to the <literal>nixos-22.05</literal> channel. To see which NixOS

     

       
65
       
65
       
 
       
    channel you’re subscribed to, run the following as root:

     

       
66
       
66
       
 
       
  </para>

     

       
67
       
67
       
 
       
  <programlisting>

     
···

       
76
       
76
       
 
       
</programlisting>

     

       
77
       
77
       
 
       
  <para>

     

       
78
       
78
       
 
       
    (Be sure to include the <literal>nixos</literal> parameter at the

     

       
79
       
79
       
-
       
    end.) For instance, to use the NixOS 21.11 stable channel:

     

       
79
       
79
       
+
       
    end.) For instance, to use the NixOS 22.05 stable channel:

     

       
80
       
80
       
 
       
  </para>

     

       
81
       
81
       
 
       
  <programlisting>

     

       
82
       
82
       
-
       
# nix-channel --add https://nixos.org/channels/nixos-21.11 nixos

     

       
82
       
82
       
+
       
# nix-channel --add https://nixos.org/channels/nixos-22.05 nixos

     

       
83
       
83
       
 
       
</programlisting>

     

       
84
       
84
       
 
       
  <para>

     

       
85
       
85
       
 
       
    If you have a server, you may want to use the <quote>small</quote>

     

       
86
       
86
       
 
       
    channel instead:

     

       
87
       
87
       
 
       
  </para>

     

       
88
       
88
       
 
       
  <programlisting>

     

       
89
       
89
       
-
       
# nix-channel --add https://nixos.org/channels/nixos-21.11-small nixos

     

       
89
       
89
       
+
       
# nix-channel --add https://nixos.org/channels/nixos-22.05-small nixos

     

       
90
       
90
       
 
       
</programlisting>

     

       
91
       
91
       
 
       
  <para>

     

       
92
       
92
       
 
       
    And if you want to live on the bleeding edge:

     
···

       
146
       
146
       
 
       
      also specify a channel explicitly, e.g.

     

       
147
       
147
       
 
       
    </para>

     

       
148
       
148
       
 
       
    <programlisting language="bash">

     

       
149
       
149
       
-
       
system.autoUpgrade.channel = https://nixos.org/channels/nixos-21.11;

     

       
149
       
149
       
+
       
system.autoUpgrade.channel = https://nixos.org/channels/nixos-22.05;

     

       
150
       
150
       
 
       
</programlisting>

     

       
151
       
151
       
 
       
  </section>

     

       
152
       
152
       
 
       
</chapter>

     

···

       
1
       
1
       
 
       
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-release-22.05">

     

       
2
       
2
       
-
       
  <title>Release 22.05 (“Quokka”, 2022.05/??)</title>

     

       
2
       
2
       
+
       
  <title>Release 22.05 (“Quokka”, 2022.05/30)</title>

     

       
3
       
3
       
 
       
  <itemizedlist spacing="compact">

     

       
4
       
4
       
 
       
    <listitem>

     

       
5
       
5
       
 
       
      <para>

     

···

       
6
       
6
       
 
       
automatically from NixOS's Git repository after certain tests have

     

       
7
       
7
       
 
       
passed and all packages have been built. These channels are:

     

       
8
       
8
       
 
       


     

       
9
       
9
       
-
       
-   *Stable channels*, such as [`nixos-21.11`](https://nixos.org/channels/nixos-21.11).

     

       
9
       
9
       
+
       
-   *Stable channels*, such as [`nixos-22.05`](https://nixos.org/channels/nixos-22.05).

     

       
10
       
10
       
 
       
    These only get conservative bug fixes and package upgrades. For

     

       
11
       
11
       
 
       
    instance, a channel update may cause the Linux kernel on your system

     

       
12
       
12
       
 
       
    to be upgraded from 4.19.34 to 4.19.38 (a minor bug fix), but not

     
···

       
19
       
19
       
 
       
    radical changes between channel updates. It's not recommended for

     

       
20
       
20
       
 
       
    production systems.

     

       
21
       
21
       
 
       


     

       
22
       
22
       
-
       
-   *Small channels*, such as [`nixos-21.11-small`](https://nixos.org/channels/nixos-21.11-small)

     

       
22
       
22
       
+
       
-   *Small channels*, such as [`nixos-22.05-small`](https://nixos.org/channels/nixos-22.05-small)

     

       
23
       
23
       
 
       
    or [`nixos-unstable-small`](https://nixos.org/channels/nixos-unstable-small).

     

       
24
       
24
       
 
       
    These are identical to the stable and unstable channels described above,

     

       
25
       
25
       
 
       
    except that they contain fewer binary packages. This means they get updated

     
···

       
38
       
38
       
 
       


     

       
39
       
39
       
 
       
When you first install NixOS, you're automatically subscribed to the

     

       
40
       
40
       
 
       
NixOS channel that corresponds to your installation source. For

     

       
41
       
41
       
-
       
instance, if you installed from a 21.11 ISO, you will be subscribed to

     

       
42
       
42
       
-
       
the `nixos-21.11` channel. To see which NixOS channel you're subscribed

     

       
41
       
41
       
+
       
instance, if you installed from a 22.05 ISO, you will be subscribed to

     

       
42
       
42
       
+
       
the `nixos-22.05` channel. To see which NixOS channel you're subscribed

     

       
43
       
43
       
 
       
to, run the following as root:

     

       
44
       
44
       
 
       


     

       
45
       
45
       
 
       
```ShellSession

     
···

       
54
       
54
       
 
       
```

     

       
55
       
55
       
 
       


     

       
56
       
56
       
 
       
(Be sure to include the `nixos` parameter at the end.) For instance, to

     

       
57
       
57
       
-
       
use the NixOS 21.11 stable channel:

     

       
57
       
57
       
+
       
use the NixOS 22.05 stable channel:

     

       
58
       
58
       
 
       


     

       
59
       
59
       
 
       
```ShellSession

     

       
60
       
60
       
-
       
# nix-channel --add https://nixos.org/channels/nixos-21.11 nixos

     

       
60
       
60
       
+
       
# nix-channel --add https://nixos.org/channels/nixos-22.05 nixos

     

       
61
       
61
       
 
       
```

     

       
62
       
62
       
 
       


     

       
63
       
63
       
 
       
If you have a server, you may want to use the "small" channel instead:

     

       
64
       
64
       
 
       


     

       
65
       
65
       
 
       
```ShellSession

     

       
66
       
66
       
-
       
# nix-channel --add https://nixos.org/channels/nixos-21.11-small nixos

     

       
66
       
66
       
+
       
# nix-channel --add https://nixos.org/channels/nixos-22.05-small nixos

     

       
67
       
67
       
 
       
```

     

       
68
       
68
       
 
       


     

       
69
       
69
       
 
       
And if you want to live on the bleeding edge:

     
···

       
114
       
114
       
 
       
modules. You can also specify a channel explicitly, e.g.

     

       
115
       
115
       
 
       


     

       
116
       
116
       
 
       
```nix

     

       
117
       
117
       
-
       
system.autoUpgrade.channel = https://nixos.org/channels/nixos-21.11;

     

       
117
       
117
       
+
       
system.autoUpgrade.channel = https://nixos.org/channels/nixos-22.05;

     

       
118
       
118
       
 
       
```

     

···

       
1
       
1
       
-
       
# Release 22.05 (“Quokka”, 2022.05/??) {#sec-release-22.05}

     

       
1
       
1
       
+
       
# Release 22.05 (“Quokka”, 2022.05/30) {#sec-release-22.05}

     

       
2
       
2
       
 
       


     

       
3
       
3
       
 
       
- Support is planned until the end of December 2022, handing over to 22.11.

     

       
4
       
4