commit 3370ee6a1322dfc353119c534c25a2c2861053c7 · pyrox.dev/nixpkgs

+28 -8
nixos/doc/manual/installation/upgrading.xml
···

       14
       14
        
       

     

       15
       15
        
       <itemizedlist>

     

       16
       16
        
         <listitem>

     

       17
       17
       -
           <para>Stable channels, such as <literal

     

       18
       18
       -
           xlink:href="https://nixos.org/channels/nixos-14.04">nixos-14.04</literal>.

     

       17
       17
       +
           <para><emphasis>Stable channels</emphasis>, such as <literal

     

       18
       18
       +
           xlink:href="https://nixos.org/channels/nixos-14.12">nixos-14.12</literal>.

     

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

     

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

     

       21
       21
        
           system to be upgraded from 3.4.66 to 3.4.67 (a minor bug fix), but

     
···

       23
       23
        
           3.11.<replaceable>x</replaceable> (a major change that has the

     

       24
       24
        
           potential to break things).  Stable channels are generally

     

       25
       25
        
           maintained until the next stable branch is created.</para>

     

       26
       26
       +
           <para></para>

     

       26
       27
        
         </listitem>

     

       27
       28
        
         <listitem>

     

       28
       28
       -
           <para>The unstable channel, <literal

     

       29
       29
       +
           <para>The <emphasis>unstable channel</emphasis>, <literal

     

       29
       30
        
           xlink:href="https://nixos.org/channels/nixos-unstable">nixos-unstable</literal>.

     

       30
       31
        
           This corresponds to NixOS’s main development branch, and may thus

     

       31
       32
        
           see radical changes between channel updates.  It’s not recommended

     

       32
       33
        
           for production systems.</para>

     

       33
       34
        
         </listitem>

     

       35
       35
       +
         <listitem>

     

       36
       36
       +
           <para><emphasis>Small channels</emphasis>, such as <literal

     

       37
       37
       +
           xlink:href="https://nixos.org/channels/nixos-14.12-small">nixos-14.12-small</literal>

     

       38
       38
       +
           or <literal

     

       39
       39
       +
           xlink:href="https://nixos.org/channels/nixos-unstable-small">nixos-unstable-small</literal>. These

     

       40
       40
       +
           are identical to the stable and unstable channels described above,

     

       41
       41
       +
           except that they contain fewer binary packages. This means they

     

       42
       42
       +
           get updated faster than the regular channels (for instance, when a

     

       43
       43
       +
           critical security patch is committed to NixOS’s source tree), but

     

       44
       44
       +
           may require more packages to be built from source than

     

       45
       45
       +
           usual. They’re mostly intended for server environments and as such

     

       46
       46
       +
           contain few GUI applications.</para>

     

       47
       47
       +
         </listitem>

     

       34
       48
        
       </itemizedlist>

     

       35
       49
        
       

     

       36
       50
        
       To see what channels are available, go to <link

     
···

       41
       55
        
       

     

       42
       56
        
       <para>When you first install NixOS, you’re automatically subscribed to

     

       43
       57
        
       the NixOS channel that corresponds to your installation source.   For

     

       44
       44
       -
       instance, if you installed from a 14.04 ISO, you will be subscribed to

     

       45
       45
       -
       the <literal>nixos-14.04</literal> channel.  To see which NixOS

     

       58
       58
       +
       instance, if you installed from a 14.12 ISO, you will be subscribed to

     

       59
       59
       +
       the <literal>nixos-14.12</literal> channel.  To see which NixOS

     

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

     

       47
       61
        
       

     

       48
       62
        
       <screen>

     
···

       57
       71
        
       </screen>

     

       58
       72
        
       

     

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

     

       60
       60
       -
       end.)  For instance, to use the NixOS 14.04 stable channel:

     

       74
       74
       +
       end.)  For instance, to use the NixOS 14.12 stable channel:

     

       61
       75
        
       

     

       62
       76
        
       <screen>

     

       63
       63
       -
       $ nix-channel --add https://nixos.org/channels/nixos-14.04 nixos

     

       77
       77
       +
       $ nix-channel --add https://nixos.org/channels/nixos-14.12 nixos

     

       64
       78
        
       </screen>

     

       65
       79
        
       

     

       66
       66
       -
       But if you want to live on the bleeding edge:

     

       80
       80
       +
       If you have a server, you may want to use the “small” channel instead:

     

       81
       81
       +
       

     

       82
       82
       +
       <screen>

     

       83
       83
       +
       $ nix-channel --add https://nixos.org/channels/nixos-14.12-small nixos

     

       84
       84
       +
       </screen>

     

       85
       85
       +
       

     

       86
       86
       +
       And if you want to live on the bleeding edge:

     

       67
       87
        
       

     

       68
       88
        
       <screen>

     

       69
       89
        
       $ nix-channel --add https://nixos.org/channels/nixos-unstable nixos