Skip to content

Instantly share code, notes, and snippets.

@nshalman

nshalman/Netboot.md

Created April 21, 2016 19:21
Show Gist options
  • Save nshalman/7c37981562c76a7d92f480722e1b97a3 to your computer and use it in GitHub Desktop.
Save nshalman/7c37981562c76a7d92f480722e1b97a3 to your computer and use it in GitHub Desktop.
Download ZIP
Netboot Installer Documentation
Raw
Netboot.md

Installing NixOS using the "netboot" media

These instructions assume that you have an existing PXE or iPXE infrastructure and simply want to add the NixOS installer as another option.

  1. Obtain netboot media consisting of:
  • bzImage -- the Linux kernel
  • initrd -- the initrd file
  • netboot.ipxe -- an example ipxe script demonstrating the appropriate kernel command line arguments for this image
  1. Place the bzImage, initrd, and optionally, the netboot.ipxe script on your HTTP/TFTP server
  2. Rename and/or customize the netboot.ipxe script with any required paths before the file names
  3. If you are not using the included netboot.ipxe file, make sure that when booted the kernel will get the appropriate kernel command line arguments that are included in it.
  4. Boot over the network
  5. Follow the NixOS installation guide as though you had booted from a CD.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment