This commit is contained in:
rycee 2023-02-26 18:44:53 +00:00
parent 30301c96d1
commit df2ca3dc72

View file

@ -33,7 +33,10 @@ As a module within a <a class="link" href="https://github.com/LnL7/nix-darwin/"
This allows the user profiles to be built together with the system
when running <code class="literal">darwin-rebuild</code>. See <a class="xref" href="index.html#sec-install-nix-darwin-module" title="1.3. nix-darwin module">Section 1.3, “nix-darwin module”</a>
for a description of this setup.
</li></ol></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-install-standalone"></a>1.1. Standalone installation</h2></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
</li></ol></div><div class="note"><h3 class="title">Note</h3><p>In this chapter we describe how to install Home Manager in the
standard way using channels. If you prefer to use
<a class="link" href="https://nixos.wiki/wiki/Flakes" target="_top">Nix Flakes</a> then please see the instructions in
<a class="xref" href="index.html#ch-nix-flakes" title="Chapter 3. Nix Flakes">Chapter 3, <em>Nix Flakes</em></a>.</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-install-standalone"></a>1.1. Standalone installation</h2></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
Make sure you have a working Nix installation. Specifically, make
sure that your user is able to build and install Nix packages. For
example, you should be able to successfully run a command like
@ -241,8 +244,26 @@ then updating Home Manager is done by first updating the channel.
You can then switch to the updated Home Manager environment.</p><pre class="programlisting console">$ nix-channel --update
unpacking channels...
$ home-manager switch</pre></div></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="ch-nix-flakes"></a>Chapter 3. Nix Flakes</h1></div></div></div><p>Home Manager includes a <code class="literal">flake.nix</code> file for compatibility with <a class="link" href="https://nixos.wiki/wiki/Flakes" target="_top">Nix Flakes</a>.
The support is still experimental and may change in backwards incompatible ways.</p><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-flakes-prerequisites"></a>3.1. Prerequisites</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
$ home-manager switch</pre></div></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="ch-nix-flakes"></a>Chapter 3. Nix Flakes</h1></div></div></div><p>Home Manager is compatible with <a class="link" href="https://nixos.wiki/wiki/Flakes" target="_top">Nix Flakes</a>. But
please be aware that the support it is still experimental and may
change in backwards incompatible ways.</p><p>Just like in the standard installation you can use the Home Manager
flake in three ways:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
Using the standalone <code class="literal">home-manager</code> tool. For platforms other than
NixOS and Darwin, this is the only available choice. It is also
recommended for people on NixOS or Darwin that want to manage their
home directory independently of the system as a whole. See
<a class="xref" href="index.html#sec-flakes-standalone" title="3.2. Standalone setup">Section 3.2, “Standalone setup”</a> for instructions on how to perform this
installation.
</li><li class="listitem">
As a module within a NixOS system configuration. This allows the
user profiles to be built together with the system when running
<code class="literal">nixos-rebuild</code>. See <a class="xref" href="index.html#sec-flakes-nixos-module" title="3.3. NixOS module">Section 3.3, “NixOS module”</a> for a description of
this setup.
</li><li class="listitem">
This allows the user profiles to be built together with the system
when running <code class="literal">darwin-rebuild</code>. See <a class="xref" href="index.html#sec-flakes-nix-darwin-module" title="3.4. nix-darwin module">Section 3.4, “nix-darwin module”</a>
for a description of this setup.
</li></ol></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-flakes-prerequisites"></a>3.1. Prerequisites</h2></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
Install Nix 2.4 or later, or have it in <code class="literal">nix-shell</code>.
</li><li class="listitem"><p class="simpara">
Enable experimental features <code class="literal">nix-command</code> and <code class="literal">flakes</code>.