···

       
14
       
14
       
 
       
  </para>

     

       
15
       
15
       
 
       
 </partintro>

     

       
16
       
16
       
 
       
 <xi:include href="../from_md/configuration/config-syntax.chapter.xml" />

     

       
17
       
17
       
-
       
 <xi:include href="package-mgmt.xml" />

     

       
17
       
17
       
+
       
 <xi:include href="../from_md/configuration/package-mgmt.chapter.xml" />

     

       
18
       
18
       
 
       
 <xi:include href="../from_md/configuration/user-mgmt.chapter.xml" />

     

       
19
       
19
       
 
       
 <xi:include href="file-systems.xml" />

     

       
20
       
20
       
 
       
 <xi:include href="../from_md/configuration/x-windows.chapter.xml" />

     

···

       
1
       
1
       
+
       
# Package Management {#sec-package-management}

     

       
2
       
2
       
+
       


     

       
3
       
3
       
+
       
This section describes how to add additional packages to your system.

     

       
4
       
4
       
+
       
NixOS has two distinct styles of package management:

     

       
5
       
5
       
+
       


     

       
6
       
6
       
+
       
-   *Declarative*, where you declare what packages you want in your

     

       
7
       
7
       
+
       
    `configuration.nix`. Every time you run `nixos-rebuild`, NixOS will

     

       
8
       
8
       
+
       
    ensure that you get a consistent set of binaries corresponding to

     

       
9
       
9
       
+
       
    your specification.

     

       
10
       
10
       
+
       


     

       
11
       
11
       
+
       
-   *Ad hoc*, where you install, upgrade and uninstall packages via the

     

       
12
       
12
       
+
       
    `nix-env` command. This style allows mixing packages from different

     

       
13
       
13
       
+
       
    Nixpkgs versions. It's the only choice for non-root users.

     

       
14
       
14
       
+
       


     

       
15
       
15
       
+
       
```{=docbook}

     

       
16
       
16
       
+
       
<xi:include href="declarative-packages.section.xml" />

     

       
17
       
17
       
+
       
<xi:include href="ad-hoc-packages.section.xml" />

     

       
18
       
18
       
+
       
```

     

···

       
1
       
1
       
-
       
<chapter xmlns="http://docbook.org/ns/docbook"

     

       
2
       
2
       
-
       
         xmlns:xlink="http://www.w3.org/1999/xlink"

     

       
3
       
3
       
-
       
         xmlns:xi="http://www.w3.org/2001/XInclude"

     

       
4
       
4
       
-
       
         version="5.0"

     

       
5
       
5
       
-
       
         xml:id="sec-package-management">

     

       
6
       
6
       
-
       
 <title>Package Management</title>

     

       
7
       
7
       
-
       
 <para>

     

       
8
       
8
       
-
       
  This section describes how to add additional packages to your system. NixOS

     

       
9
       
9
       
-
       
  has two distinct styles of package management:

     

       
10
       
10
       
-
       
  <itemizedlist>

     

       
11
       
11
       
-
       
   <listitem>

     

       
12
       
12
       
-
       
    <para>

     

       
13
       
13
       
-
       
     <emphasis>Declarative</emphasis>, where you declare what packages you want

     

       
14
       
14
       
-
       
     in your <filename>configuration.nix</filename>. Every time you run

     

       
15
       
15
       
-
       
     <command>nixos-rebuild</command>, NixOS will ensure that you get a

     

       
16
       
16
       
-
       
     consistent set of binaries corresponding to your specification.

     

       
17
       
17
       
-
       
    </para>

     

       
18
       
18
       
-
       
   </listitem>

     

       
19
       
19
       
-
       
   <listitem>

     

       
20
       
20
       
-
       
    <para>

     

       
21
       
21
       
-
       
     <emphasis>Ad hoc</emphasis>, where you install, upgrade and uninstall

     

       
22
       
22
       
-
       
     packages via the <command>nix-env</command> command. This style allows

     

       
23
       
23
       
-
       
     mixing packages from different Nixpkgs versions. It’s the only choice

     

       
24
       
24
       
-
       
     for non-root users.

     

       
25
       
25
       
-
       
    </para>

     

       
26
       
26
       
-
       
   </listitem>

     

       
27
       
27
       
-
       
  </itemizedlist>

     

       
28
       
28
       
-
       
 </para>

     

       
29
       
29
       
-
       
 <xi:include href="../from_md/configuration/declarative-packages.section.xml" />

     

       
30
       
30
       
-
       
 <xi:include href="../from_md/configuration/ad-hoc-packages.section.xml" />

     

       
31
       
31
       
-
       
</chapter>

     

···

       
1
       
1
       
+
       
<chapter xmlns="http://docbook.org/ns/docbook"  xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="sec-package-management">

     

       
2
       
2
       
+
       
  <title>Package Management</title>

     

       
3
       
3
       
+
       
  <para>

     

       
4
       
4
       
+
       
    This section describes how to add additional packages to your

     

       
5
       
5
       
+
       
    system. NixOS has two distinct styles of package management:

     

       
6
       
6
       
+
       
  </para>

     

       
7
       
7
       
+
       
  <itemizedlist>

     

       
8
       
8
       
+
       
    <listitem>

     

       
9
       
9
       
+
       
      <para>

     

       
10
       
10
       
+
       
        <emphasis>Declarative</emphasis>, where you declare what

     

       
11
       
11
       
+
       
        packages you want in your <literal>configuration.nix</literal>.

     

       
12
       
12
       
+
       
        Every time you run <literal>nixos-rebuild</literal>, NixOS will

     

       
13
       
13
       
+
       
        ensure that you get a consistent set of binaries corresponding

     

       
14
       
14
       
+
       
        to your specification.

     

       
15
       
15
       
+
       
      </para>

     

       
16
       
16
       
+
       
    </listitem>

     

       
17
       
17
       
+
       
    <listitem>

     

       
18
       
18
       
+
       
      <para>

     

       
19
       
19
       
+
       
        <emphasis>Ad hoc</emphasis>, where you install, upgrade and

     

       
20
       
20
       
+
       
        uninstall packages via the <literal>nix-env</literal> command.

     

       
21
       
21
       
+
       
        This style allows mixing packages from different Nixpkgs

     

       
22
       
22
       
+
       
        versions. It’s the only choice for non-root users.

     

       
23
       
23
       
+
       
      </para>

     

       
24
       
24
       
+
       
    </listitem>

     

       
25
       
25
       
+
       
  </itemizedlist>

     

       
26
       
26
       
+
       
  <xi:include href="declarative-packages.section.xml" />

     

       
27
       
27
       
+
       
  <xi:include href="ad-hoc-packages.section.xml" />

     

       
28
       
28
       
+
       
</chapter>