···

       
11
       
 
       


     

       
12
       
 
       
<refnamediv>

     

       
13
       
 
       
  <refname><command>nixos-install</command></refname>

     

       
14
       
-
       
  <refpurpose>install NixOS</refpurpose>

     

       
15
       
 
       
</refnamediv>

     

       
16
       
 
       


     

       
17
       
 
       
<refsynopsisdiv>

     

       
18
       
 
       
  <cmdsynopsis>

     

       
19
       
 
       
    <command>nixos-install</command>

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
20
       
 
       
  </cmdsynopsis>

     

       
21
       
 
       
</refsynopsisdiv>

     

       
22
       
 
       


     
···

       
55
       
 
       


     

       
56
       
 
       
</refsection>

     

       
57
       
 
       


     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
58
       
 
       


     

       
59
       
 
       
<refsection><title>Examples</title>

     

       
60
       
 
       


     
···

       
72
       
 
       
$ nixos-generate-config --root /mnt

     

       
73
       
 
       
$ # edit /mnt/etc/nixos/configuration.nix

     

       
74
       
 
       
$ nixos-install

     

       
0
       
 
       

     

       
75
       
 
       
</screen>

     

       
76
       
 
       


     

       
77
       
 
       
</para>

     

···

       
11
       
 
       


     

       
12
       
 
       
<refnamediv>

     

       
13
       
 
       
  <refname><command>nixos-install</command></refname>

     

       
14
       
+
       
  <refpurpose>install bootloader and NixOS</refpurpose>

     

       
15
       
 
       
</refnamediv>

     

       
16
       
 
       


     

       
17
       
 
       
<refsynopsisdiv>

     

       
18
       
 
       
  <cmdsynopsis>

     

       
19
       
 
       
    <command>nixos-install</command>

     

       
20
       
+
       
    <arg>

     

       
21
       
+
       
      <arg choice='plain'><option>-I</option></arg>

     

       
22
       
+
       
      <replaceable>path</replaceable>

     

       
23
       
+
       
    </arg>

     

       
24
       
+
       
    <arg>

     

       
25
       
+
       
      <arg choice='plain'><option>--root</option></arg>

     

       
26
       
+
       
      <replaceable>root</replaceable>

     

       
27
       
+
       
    </arg>

     

       
28
       
+
       
    <arg>

     

       
29
       
+
       
      <arg choice='plain'><option>--show-trace</option></arg>

     

       
30
       
+
       
    </arg>

     

       
31
       
+
       
    <arg>

     

       
32
       
+
       
      <arg choice='plain'><option>--chroot</option></arg>

     

       
33
       
+
       
    </arg>

     

       
34
       
+
       
    <arg>

     

       
35
       
+
       
      <arg choice='plain'><option>--help</option></arg>

     

       
36
       
+
       
    </arg>

     

       
37
       
 
       
  </cmdsynopsis>

     

       
38
       
 
       
</refsynopsisdiv>

     

       
39
       
 
       


     
···

       
72
       
 
       


     

       
73
       
 
       
</refsection>

     

       
74
       
 
       


     

       
75
       
+
       
<refsection><title>Options</title>

     

       
76
       
+
       


     

       
77
       
+
       
<para>This command accepts the following options:</para>

     

       
78
       
+
       


     

       
79
       
+
       
<variablelist>

     

       
80
       
+
       


     

       
81
       
+
       
  <varlistentry>

     

       
82
       
+
       
    <term><option>--root</option></term>

     

       
83
       
+
       
    <listitem>

     

       
84
       
+
       
      <para>Defaults to <filename>/mnt</filename>. If this option is given, treat the directory

     

       
85
       
+
       
      <replaceable>root</replaceable> as the root of the NixOS installation.

     

       
86
       
+
       
      </para>

     

       
87
       
+
       
    </listitem>

     

       
88
       
+
       
  </varlistentry>

     

       
89
       
+
       


     

       
90
       
+
       
  <varlistentry>

     

       
91
       
+
       
    <term><option>-I</option></term>

     

       
92
       
+
       
    <listitem>

     

       
93
       
+
       
      <para>Add a path to the Nix expression search path. This option may be given multiple times.

     

       
94
       
+
       
        See the NIX_PATH environment variable for information on the semantics of the Nix search path.

     

       
95
       
+
       
        Paths added through <replaceable>-I</replaceable> take precedence over NIX_PATH.</para>

     

       
96
       
+
       
    </listitem>

     

       
97
       
+
       
  </varlistentry>

     

       
98
       
+
       


     

       
99
       
+
       
  <varlistentry>

     

       
100
       
+
       
    <term><option>--show-trace</option></term>

     

       
101
       
+
       
    <listitem>

     

       
102
       
+
       
      <para>Causes Nix to print out a stack trace in case of Nix expression evaluation errors.</para>

     

       
103
       
+
       
    </listitem>

     

       
104
       
+
       
  </varlistentry>

     

       
105
       
+
       


     

       
106
       
+
       
  <varlistentry>

     

       
107
       
+
       
    <term><option>--chroot</option></term>

     

       
108
       
+
       
    <listitem>

     

       
109
       
+
       
      <para>Chroot into given installation. Any additional arguments passed are going to be executed inside the chroot.

     

       
110
       
+
       
      </para>

     

       
111
       
+
       
    </listitem>

     

       
112
       
+
       
  </varlistentry>

     

       
113
       
+
       


     

       
114
       
+
       
  <varlistentry>

     

       
115
       
+
       
    <term><option>--help</option></term>

     

       
116
       
+
       
    <listitem>

     

       
117
       
+
       
      <para>Synonym for <command>man nixos-install</command>.</para>

     

       
118
       
+
       
    </listitem>

     

       
119
       
+
       
  </varlistentry>

     

       
120
       
+
       


     

       
121
       
+
       
</variablelist>

     

       
122
       
+
       


     

       
123
       
+
       
</refsection>

     

       
124
       
+
       


     

       
125
       
 
       


     

       
126
       
 
       
<refsection><title>Examples</title>

     

       
127
       
 
       


     
···

       
139
       
 
       
$ nixos-generate-config --root /mnt

     

       
140
       
 
       
$ # edit /mnt/etc/nixos/configuration.nix

     

       
141
       
 
       
$ nixos-install

     

       
142
       
+
       
$ reboot

     

       
143
       
 
       
</screen>

     

       
144
       
 
       


     

       
145
       
 
       
</para>

     

···

       
15
       
 
       
    </author>

     

       
16
       
 
       


     

       
17
       
 
       
    <copyright>

     

       
18
       
-
       
      <year>2007-2013</year>

     

       
19
       
 
       
      <holder>Eelco Dolstra</holder>

     

       
20
       
 
       
    </copyright>

     

       
21
       
 
       


     

···

       
15
       
 
       
    </author>

     

       
16
       
 
       


     

       
17
       
 
       
    <copyright>

     

       
18
       
+
       
      <year>2007-2015</year>

     

       
19
       
 
       
      <holder>Eelco Dolstra</holder>

     

       
20
       
 
       
    </copyright>

     

       
21