commit 865b3918f2a0853dfadc104394bbc98be114cf17 · pyrox.dev/nixpkgs

+51

nixos/doc/manual/configuration/ad-hoc-packages.section.md

···

       1
       1
       +
       # Ad-Hoc Package Management {#sec-ad-hoc-packages}

     

       2
       2
       +
       

     

       3
       3
       +
       With the command `nix-env`, you can install and uninstall packages from

     

       4
       4
       +
       the command line. For instance, to install Mozilla Thunderbird:

     

       5
       5
       +
       

     

       6
       6
       +
       ```ShellSession

     

       7
       7
       +
       $ nix-env -iA nixos.thunderbird

     

       8
       8
       +
       ```

     

       9
       9
       +
       

     

       10
       10
       +
       If you invoke this as root, the package is installed in the Nix profile

     

       11
       11
       +
       `/nix/var/nix/profiles/default` and visible to all users of the system;

     

       12
       12
       +
       otherwise, the package ends up in

     

       13
       13
       +
       `/nix/var/nix/profiles/per-user/username/profile` and is not visible to

     

       14
       14
       +
       other users. The `-A` flag specifies the package by its attribute name;

     

       15
       15
       +
       without it, the package is installed by matching against its package

     

       16
       16
       +
       name (e.g. `thunderbird`). The latter is slower because it requires

     

       17
       17
       +
       matching against all available Nix packages, and is ambiguous if there

     

       18
       18
       +
       are multiple matching packages.

     

       19
       19
       +
       

     

       20
       20
       +
       Packages come from the NixOS channel. You typically upgrade a package by

     

       21
       21
       +
       updating to the latest version of the NixOS channel:

     

       22
       22
       +
       

     

       23
       23
       +
       ```ShellSession

     

       24
       24
       +
       $ nix-channel --update nixos

     

       25
       25
       +
       ```

     

       26
       26
       +
       

     

       27
       27
       +
       and then running `nix-env -i` again. Other packages in the profile are

     

       28
       28
       +
       *not* affected; this is the crucial difference with the declarative

     

       29
       29
       +
       style of package management, where running `nixos-rebuild switch` causes

     

       30
       30
       +
       all packages to be updated to their current versions in the NixOS

     

       31
       31
       +
       channel. You can however upgrade all packages for which there is a newer

     

       32
       32
       +
       version by doing:

     

       33
       33
       +
       

     

       34
       34
       +
       ```ShellSession

     

       35
       35
       +
       $ nix-env -u '*'

     

       36
       36
       +
       ```

     

       37
       37
       +
       

     

       38
       38
       +
       A package can be uninstalled using the `-e` flag:

     

       39
       39
       +
       

     

       40
       40
       +
       ```ShellSession

     

       41
       41
       +
       $ nix-env -e thunderbird

     

       42
       42
       +
       ```

     

       43
       43
       +
       

     

       44
       44
       +
       Finally, you can roll back an undesirable `nix-env` action:

     

       45
       45
       +
       

     

       46
       46
       +
       ```ShellSession

     

       47
       47
       +
       $ nix-env --rollback

     

       48
       48
       +
       ```

     

       49
       49
       +
       

     

       50
       50
       +
       `nix-env` has many more flags. For details, see the nix-env(1) manpage or

     

       51
       51
       +
       the Nix manual.

-61

nixos/doc/manual/configuration/ad-hoc-packages.xml

···

       1
       1
       -
       <section 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-ad-hoc-packages">

     

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

     

       7
       7
       -
       

     

       8
       8
       -
        <para>

     

       9
       9
       -
         With the command <command>nix-env</command>, you can install and uninstall

     

       10
       10
       -
         packages from the command line. For instance, to install Mozilla Thunderbird:

     

       11
       11
       -
       <screen>

     

       12
       12
       -
       <prompt>$ </prompt>nix-env -iA nixos.thunderbird</screen>

     

       13
       13
       -
         If you invoke this as root, the package is installed in the Nix profile

     

       14
       14
       -
         <filename>/nix/var/nix/profiles/default</filename> and visible to all users

     

       15
       15
       -
         of the system; otherwise, the package ends up in

     

       16
       16
       -
         <filename>/nix/var/nix/profiles/per-user/<replaceable>username</replaceable>/profile</filename>

     

       17
       17
       -
         and is not visible to other users. The <option>-A</option> flag specifies the

     

       18
       18
       -
         package by its attribute name; without it, the package is installed by

     

       19
       19
       -
         matching against its package name (e.g. <literal>thunderbird</literal>). The

     

       20
       20
       -
         latter is slower because it requires matching against all available Nix

     

       21
       21
       -
         packages, and is ambiguous if there are multiple matching packages.

     

       22
       22
       -
        </para>

     

       23
       23
       -
       

     

       24
       24
       -
        <para>

     

       25
       25
       -
         Packages come from the NixOS channel. You typically upgrade a package by

     

       26
       26
       -
         updating to the latest version of the NixOS channel:

     

       27
       27
       -
       <screen>

     

       28
       28
       -
       <prompt>$ </prompt>nix-channel --update nixos

     

       29
       29
       -
       </screen>

     

       30
       30
       -
         and then running <literal>nix-env -i</literal> again. Other packages in the

     

       31
       31
       -
         profile are <emphasis>not</emphasis> affected; this is the crucial difference

     

       32
       32
       -
         with the declarative style of package management, where running

     

       33
       33
       -
         <command>nixos-rebuild switch</command> causes all packages to be updated to

     

       34
       34
       -
         their current versions in the NixOS channel. You can however upgrade all

     

       35
       35
       -
         packages for which there is a newer version by doing:

     

       36
       36
       -
       <screen>

     

       37
       37
       -
       <prompt>$ </prompt>nix-env -u '*'

     

       38
       38
       -
       </screen>

     

       39
       39
       -
        </para>

     

       40
       40
       -
       

     

       41
       41
       -
        <para>

     

       42
       42
       -
         A package can be uninstalled using the <option>-e</option> flag:

     

       43
       43
       -
       <screen>

     

       44
       44
       -
       <prompt>$ </prompt>nix-env -e thunderbird

     

       45
       45
       -
       </screen>

     

       46
       46
       -
        </para>

     

       47
       47
       -
       

     

       48
       48
       -
        <para>

     

       49
       49
       -
         Finally, you can roll back an undesirable <command>nix-env</command> action:

     

       50
       50
       -
       <screen>

     

       51
       51
       -
       <prompt>$ </prompt>nix-env --rollback

     

       52
       52
       -
       </screen>

     

       53
       53
       -
        </para>

     

       54
       54
       -
       

     

       55
       55
       -
        <para>

     

       56
       56
       -
         <command>nix-env</command> has many more flags. For details, see the

     

       57
       57
       -
         <citerefentry>

     

       58
       58
       -
         <refentrytitle>nix-env</refentrytitle>

     

       59
       59
       -
         <manvolnum>1</manvolnum></citerefentry> manpage or the Nix manual.

     

       60
       60
       -
        </para>

     

       61
       61
       -
       </section>

+1 -1

nixos/doc/manual/configuration/package-mgmt.xml

···

       27
       27
        
         </itemizedlist>

     

       28
       28
        
        </para>

     

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

     

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

     

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

     

       31
       31
        
       </chapter>

+59

nixos/doc/manual/from_md/configuration/ad-hoc-packages.section.xml

···

       1
       1
       +
       <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-ad-hoc-packages">

     

       2
       2
       +
         <title>Ad-Hoc Package Management</title>

     

       3
       3
       +
         <para>

     

       4
       4
       +
           With the command <literal>nix-env</literal>, you can install and

     

       5
       5
       +
           uninstall packages from the command line. For instance, to install

     

       6
       6
       +
           Mozilla Thunderbird:

     

       7
       7
       +
         </para>

     

       8
       8
       +
         <programlisting>

     

       9
       9
       +
       $ nix-env -iA nixos.thunderbird

     

       10
       10
       +
       </programlisting>

     

       11
       11
       +
         <para>

     

       12
       12
       +
           If you invoke this as root, the package is installed in the Nix

     

       13
       13
       +
           profile <literal>/nix/var/nix/profiles/default</literal> and visible

     

       14
       14
       +
           to all users of the system; otherwise, the package ends up in

     

       15
       15
       +
           <literal>/nix/var/nix/profiles/per-user/username/profile</literal>

     

       16
       16
       +
           and is not visible to other users. The <literal>-A</literal> flag

     

       17
       17
       +
           specifies the package by its attribute name; without it, the package

     

       18
       18
       +
           is installed by matching against its package name (e.g.

     

       19
       19
       +
           <literal>thunderbird</literal>). The latter is slower because it

     

       20
       20
       +
           requires matching against all available Nix packages, and is

     

       21
       21
       +
           ambiguous if there are multiple matching packages.

     

       22
       22
       +
         </para>

     

       23
       23
       +
         <para>

     

       24
       24
       +
           Packages come from the NixOS channel. You typically upgrade a

     

       25
       25
       +
           package by updating to the latest version of the NixOS channel:

     

       26
       26
       +
         </para>

     

       27
       27
       +
         <programlisting>

     

       28
       28
       +
       $ nix-channel --update nixos

     

       29
       29
       +
       </programlisting>

     

       30
       30
       +
         <para>

     

       31
       31
       +
           and then running <literal>nix-env -i</literal> again. Other packages

     

       32
       32
       +
           in the profile are <emphasis>not</emphasis> affected; this is the

     

       33
       33
       +
           crucial difference with the declarative style of package management,

     

       34
       34
       +
           where running <literal>nixos-rebuild switch</literal> causes all

     

       35
       35
       +
           packages to be updated to their current versions in the NixOS

     

       36
       36
       +
           channel. You can however upgrade all packages for which there is a

     

       37
       37
       +
           newer version by doing:

     

       38
       38
       +
         </para>

     

       39
       39
       +
         <programlisting>

     

       40
       40
       +
       $ nix-env -u '*'

     

       41
       41
       +
       </programlisting>

     

       42
       42
       +
         <para>

     

       43
       43
       +
           A package can be uninstalled using the <literal>-e</literal> flag:

     

       44
       44
       +
         </para>

     

       45
       45
       +
         <programlisting>

     

       46
       46
       +
       $ nix-env -e thunderbird

     

       47
       47
       +
       </programlisting>

     

       48
       48
       +
         <para>

     

       49
       49
       +
           Finally, you can roll back an undesirable <literal>nix-env</literal>

     

       50
       50
       +
           action:

     

       51
       51
       +
         </para>

     

       52
       52
       +
         <programlisting>

     

       53
       53
       +
       $ nix-env --rollback

     

       54
       54
       +
       </programlisting>

     

       55
       55
       +
         <para>

     

       56
       56
       +
           <literal>nix-env</literal> has many more flags. For details, see the

     

       57
       57
       +
           nix-env(1) manpage or the Nix manual.

     

       58
       58
       +
         </para>

     

       59
       59
       +
       </section>