2014-08-24 17:18:18 +00:00
|
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
|
|
version="5.0"
|
|
|
|
xml:id="sec-declarative-package-mgmt">
|
2018-05-01 23:57:09 +00:00
|
|
|
<title>Declarative Package Management</title>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
With declarative package management, you specify which packages you want on
|
|
|
|
your system by setting the option
|
|
|
|
<xref linkend="opt-environment.systemPackages"/>. For instance, adding the
|
|
|
|
following line to <filename>configuration.nix</filename> enables the Mozilla
|
|
|
|
Thunderbird email application:
|
2014-08-24 17:18:18 +00:00
|
|
|
<programlisting>
|
2018-04-05 08:43:56 +00:00
|
|
|
<xref linkend="opt-environment.systemPackages"/> = [ pkgs.thunderbird ];
|
2014-08-24 17:18:18 +00:00
|
|
|
</programlisting>
|
2018-05-01 23:57:09 +00:00
|
|
|
The effect of this specification is that the Thunderbird package from Nixpkgs
|
|
|
|
will be built or downloaded as part of the system when you run
|
|
|
|
<command>nixos-rebuild switch</command>.
|
|
|
|
</para>
|
2014-08-24 17:18:18 +00:00
|
|
|
|
2018-05-01 23:57:09 +00:00
|
|
|
<para>
|
|
|
|
You can get a list of the available packages as follows:
|
2014-08-24 17:18:18 +00:00
|
|
|
<screen>
|
|
|
|
$ nix-env -qaP '*' --description
|
2015-08-05 15:29:08 +00:00
|
|
|
nixos.firefox firefox-23.0 Mozilla Firefox - the browser, reloaded
|
2014-08-24 17:18:18 +00:00
|
|
|
<replaceable>...</replaceable>
|
|
|
|
</screen>
|
2018-05-01 23:57:09 +00:00
|
|
|
The first column in the output is the <emphasis>attribute name</emphasis>,
|
|
|
|
such as <literal>nixos.thunderbird</literal>. (The <literal>nixos</literal>
|
|
|
|
prefix allows distinguishing between different channels that you might have.)
|
|
|
|
</para>
|
2014-08-24 17:18:18 +00:00
|
|
|
|
2018-05-01 23:57:09 +00:00
|
|
|
<para>
|
|
|
|
To “uninstall” a package, simply remove it from
|
|
|
|
<xref linkend="opt-environment.systemPackages"/> and run
|
|
|
|
<command>nixos-rebuild switch</command>.
|
|
|
|
</para>
|
2014-08-24 17:18:18 +00:00
|
|
|
|
2018-05-01 23:57:09 +00:00
|
|
|
<xi:include href="customizing-packages.xml" />
|
2014-08-24 17:18:18 +00:00
|
|
|
|
2018-05-01 23:57:09 +00:00
|
|
|
<xi:include href="adding-custom-packages.xml" />
|
2014-08-24 17:18:18 +00:00
|
|
|
</section>
|