Skip to content

Instantly share code, notes, and snippets.

@nshalman

nshalman/Netboot.md

Last active April 21, 2016 20:54
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save nshalman/2a6004360482b8478ab14ec59827edd3 to your computer and use it in GitHub Desktop.
Save nshalman/2a6004360482b8478ab14ec59827edd3 to your computer and use it in GitHub Desktop.
Download ZIP
Netboot Installer Documentation
Raw
Netboot.md

Installing NixOS using the "netboot" media

Advanced users may wish to install NixOS using an existing PXE or iPXE setup.

These instructions assume that you have an existing PXE or iPXE 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:

nix-build -A netboot nixos/release.nix

This will create a result directory containing:

  • bzImage -- the Linux kernel
  • initrd -- the initrd file
  • netboot.ipxe -- an example ipxe script demonstrating the appropriate kernel command line arguments for this image

If you're using plain PXE, configure your boot loader to use the bzImage and initrd files and have it provide the same kernel command line arguments found in netboot.ipxe.

If you're using iPXE, depending on how your HTTP/FTP/etc. server is configured you may be able to use netboot.ipxe unmodified, or you may need to update the paths to the files to match your server's directory layout

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment