diff options
author | Bobby Rong <rjl931189261@126.com> | 2021-09-08 15:47:05 +0800 |
---|---|---|
committer | Bobby Rong <rjl931189261@126.com> | 2021-09-08 15:47:05 +0800 |
commit | 8ce611b9fb664b6860b55f003d0b42a1dd0ab8e9 (patch) | |
tree | c55f9781ea4ddb1adb773f0c97b797be8a6b8cb7 /nixos/doc/manual/from_md/configuration | |
parent | 3d711cfc5e1205672dd6808909773dba8c26fe34 (diff) | |
download | nixpkgs-8ce611b9fb664b6860b55f003d0b42a1dd0ab8e9.tar nixpkgs-8ce611b9fb664b6860b55f003d0b42a1dd0ab8e9.tar.gz nixpkgs-8ce611b9fb664b6860b55f003d0b42a1dd0ab8e9.tar.bz2 nixpkgs-8ce611b9fb664b6860b55f003d0b42a1dd0ab8e9.tar.lz nixpkgs-8ce611b9fb664b6860b55f003d0b42a1dd0ab8e9.tar.xz nixpkgs-8ce611b9fb664b6860b55f003d0b42a1dd0ab8e9.tar.zst nixpkgs-8ce611b9fb664b6860b55f003d0b42a1dd0ab8e9.zip |
nixos: nixos/doc/manual/configuration/declarative-packages.xml to CommonMark
Diffstat (limited to 'nixos/doc/manual/from_md/configuration')
-rw-r--r-- | nixos/doc/manual/from_md/configuration/declarative-packages.section.xml | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/nixos/doc/manual/from_md/configuration/declarative-packages.section.xml b/nixos/doc/manual/from_md/configuration/declarative-packages.section.xml new file mode 100644 index 00000000000..da31f18d923 --- /dev/null +++ b/nixos/doc/manual/from_md/configuration/declarative-packages.section.xml @@ -0,0 +1,53 @@ +<section 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-declarative-package-mgmt"> + <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 <literal>configuration.nix</literal> + enables the Mozilla Thunderbird email application: + </para> + <programlisting language="bash"> +environment.systemPackages = [ pkgs.thunderbird ]; +</programlisting> + <para> + 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 <literal>nixos-rebuild switch</literal>. + </para> + <note> + <para> + Some packages require additional global configuration such as + D-Bus or systemd service registration so adding them to + <xref linkend="opt-environment.systemPackages" /> might not be + sufficient. You are advised to check the + <link linkend="ch-options">list of options</link> whether a NixOS + module for the package does not exist. + </para> + </note> + <para> + You can get a list of the available packages as follows: + </para> + <programlisting> +$ nix-env -qaP '*' --description +nixos.firefox firefox-23.0 Mozilla Firefox - the browser, reloaded +... +</programlisting> + <para> + The first column in the output is the <emphasis>attribute + name</emphasis>, such as <literal>nixos.thunderbird</literal>. + </para> + <para> + Note: the <literal>nixos</literal> prefix tells us that we want to + get the package from the <literal>nixos</literal> channel and works + only in CLI tools. In declarative configuration use + <literal>pkgs</literal> prefix (variable). + </para> + <para> + To <quote>uninstall</quote> a package, simply remove it from + <xref linkend="opt-environment.systemPackages" /> and run + <literal>nixos-rebuild switch</literal>. + </para> + <xi:include href="customizing-packages.section.xml" /> + <xi:include href="adding-custom-packages.section.xml" /> +</section> |