2016-04-29 10:41:13 +01:00
|
|
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
|
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
|
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
|
|
|
version="5.0"
|
|
|
|
|
xml:id="sec-booting-from-pxe">
|
2018-05-02 00:57:09 +01:00
|
|
|
|
<title>Booting from the <quote>netboot</quote> media (PXE)</title>
|
2016-04-29 10:41:13 +01:00
|
|
|
|
|
2018-05-02 00:57:09 +01:00
|
|
|
|
<para>
|
|
|
|
|
Advanced users may wish to install NixOS using an existing PXE or iPXE setup.
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>
|
2016-04-29 10:41:13 +01:00
|
|
|
|
These instructions assume that you have an existing PXE or iPXE
|
2018-05-02 00:57:09 +01:00
|
|
|
|
infrastructure and simply want to add the NixOS installer as another option.
|
|
|
|
|
To build the necessary files from a recent version of nixpkgs, you can run:
|
|
|
|
|
</para>
|
|
|
|
|
|
2016-04-29 10:41:13 +01:00
|
|
|
|
<programlisting>
|
|
|
|
|
nix-build -A netboot nixos/release.nix
|
|
|
|
|
</programlisting>
|
2018-05-02 00:57:09 +01:00
|
|
|
|
|
|
|
|
|
<para>
|
2016-04-29 10:41:13 +01:00
|
|
|
|
This will create a <literal>result</literal> directory containing: *
|
2018-05-02 00:57:09 +01:00
|
|
|
|
<literal>bzImage</literal> – the Linux kernel * <literal>initrd</literal>
|
|
|
|
|
– the initrd file * <literal>netboot.ipxe</literal> – an example ipxe
|
|
|
|
|
script demonstrating the appropriate kernel command line arguments for this
|
2016-04-29 10:41:13 +01:00
|
|
|
|
image
|
2018-05-02 00:57:09 +01:00
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>
|
2016-04-29 10:41:13 +01:00
|
|
|
|
If you’re using plain PXE, configure your boot loader to use the
|
2018-05-02 00:57:09 +01:00
|
|
|
|
<literal>bzImage</literal> and <literal>initrd</literal> files and have it
|
|
|
|
|
provide the same kernel command line arguments found in
|
2016-04-29 10:41:13 +01:00
|
|
|
|
<literal>netboot.ipxe</literal>.
|
2018-05-02 00:57:09 +01:00
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>
|
2016-04-29 10:41:13 +01:00
|
|
|
|
If you’re using iPXE, depending on how your HTTP/FTP/etc. server is
|
2018-05-02 00:57:09 +01:00
|
|
|
|
configured you may be able to use <literal>netboot.ipxe</literal> unmodified,
|
|
|
|
|
or you may need to update the paths to the files to match your server’s
|
|
|
|
|
directory layout
|
|
|
|
|
</para>
|
2016-04-29 10:41:13 +01:00
|
|
|
|
|
2018-05-02 00:57:09 +01:00
|
|
|
|
<para>
|
|
|
|
|
In the future we may begin making these files available as build products
|
|
|
|
|
from hydra at which point we will update this documentation with instructions
|
|
|
|
|
on how to obtain them either for placing on a dedicated TFTP server or to
|
|
|
|
|
boot them directly over the internet.
|
|
|
|
|
</para>
|
2016-04-29 10:41:13 +01:00
|
|
|
|
</section>
|