aboutsummaryrefslogtreecommitdiff
path: root/doc/installation.xml
diff options
context:
space:
mode:
authorErik Arvstedt <erik.arvstedt@gmail.com>2020-03-01 17:06:20 +0100
committerRobert Helgesson <robert@rycee.net>2020-03-07 14:25:00 +0100
commitefbe1383e64585ebc0303f4703e7e582aaf6b933 (patch)
tree619bb447d636c4e6b8f4cdbbd815ee4bbc5a2d69 /doc/installation.xml
parentc7b43786ad5740f8ae054cb97d3493c585920031 (diff)
nixos integration: add option 'useGlobalPkgs'
PR #1059
Diffstat (limited to 'doc/installation.xml')
-rw-r--r--doc/installation.xml17
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/installation.xml b/doc/installation.xml
index 52119886800..9c5d24b3d92 100644
--- a/doc/installation.xml
+++ b/doc/installation.xml
@@ -225,6 +225,23 @@ home-manager.useUserPackages = true;
become the default value in the future.
</para>
</note>
+
+ <note>
+ <para>
+ By default, Home Manager uses a private <literal>pkgs</literal> instance
+ that is configured via the <option>home-manager.users.&lt;name&gt;.nixpkgs</option> options.
+ To instead use the global <literal>pkgs</literal> that is configured via
+ the system level <option>nixpkgs</option> options, set
+ </para>
+<programlisting language="nix">
+home-manager.useGlobalPkgs = true;
+</programlisting>
+ <para>
+ This saves an extra Nixpkgs evaluation, adds consistency, and removes the
+ dependency on <envar>NIX_PATH</envar>, which is otherwise used for
+ importing Nixpkgs.
+ </para>
+ </note>
</section>
<section xml:id="sec-install-nix-darwin-module">
<title>nix-darwin module</title>