Document EFI installation
Signed-off-by: Shea Levy <shea@shealevy.com>
This commit is contained in:
parent
d6ef65cb6a
commit
448dc031ed
@ -295,8 +295,73 @@ $ reboot</screen>
|
|||||||
}</screen>
|
}</screen>
|
||||||
</example>
|
</example>
|
||||||
|
|
||||||
|
<section>
|
||||||
|
|
||||||
|
<title>UEFI Installation</title>
|
||||||
|
|
||||||
|
<para>NixOS can also be installed on UEFI systems. The procedure
|
||||||
|
is by and large the same as a BIOS installation, with the following
|
||||||
|
changes:
|
||||||
|
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>You should boot the livecd in UEFI mode (consult your specific
|
||||||
|
hardware's documentation for instructions how).</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Instead of <command>fdisk</command>, you should use <command>
|
||||||
|
gdisk</command> to partition your disks. You will need to have a
|
||||||
|
separate partition for <filename>/boot</filename> with partition code
|
||||||
|
EF00, and it should be formatted with a vfat filesystem.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>You must set <option>boot.loader.gummiboot.enable</option> to
|
||||||
|
<literal>true</literal>, and <option>boot.loader.grub.enable</option>
|
||||||
|
to <literal>false</literal>. <command>nixos-generate-config</command>
|
||||||
|
should do this automatically for new configurations when booted in
|
||||||
|
UEFI mode.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>You may want to look at the options starting with
|
||||||
|
<option>boot.loader.efi</option> and <option>boot.loader.gummiboot</option>
|
||||||
|
as well.</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>To see console messages during early boot, put <literal>"fbcon"</literal>
|
||||||
|
in your <option>boot.initrd.kernelModules</option></para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</para>
|
||||||
|
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
|
<section>
|
||||||
|
|
||||||
|
<title>Booting from a USB stick</title>
|
||||||
|
|
||||||
|
<para>For systems withoua CD drive, the NixOS livecd can be booted from
|
||||||
|
a usb stick. For non-UEFI installations,
|
||||||
|
<link xlink:href="http://unetbootin.sourceforge.net/">unetbootin</link>
|
||||||
|
will work. For UEFI installations, you should mount the ISO, copy its contents
|
||||||
|
verbatim to your drive, then either:
|
||||||
|
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>Change the label of the disk partition to the label of the ISO
|
||||||
|
(visible with the blkid command), or</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Edit <filename>loader/entries/nixos-livecd.conf</filename> on the drive
|
||||||
|
and change the <literal>root=</literal> field in the <literal>options</literal>
|
||||||
|
line to point to your drive (see the documentation on <literal>root=</literal>
|
||||||
|
in <link xlink:href="https://www.kernel.org/doc/Documentation/kernel-parameters.txt">
|
||||||
|
the kernel documentation</link> for more details).</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
</para>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
</section>
|
||||||
|
|
||||||
|
|
||||||
<!--===============================================================-->
|
<!--===============================================================-->
|
||||||
|
Loading…
Reference in New Issue
Block a user