NixOS Installation Guide
This guide is a companion guide for the official manual. In addition to describing the steps from the official manual, it provides known good instructions for common use cases. When there is a discrepancy between the manual and this guide, the supported case is the one described in the manual.
Use this guide as a step-by-step guide, choices will be presented, use only the selected section, and continue at the section it tells you to at the end.
- 1 Installation target
- 2 Installation method
- 3 Making the installation media
- 4 Booting the installation media
- 5 Connecting to the internet
- 6 Tethered (Internet Sharing)
- 7 Additional notes for specific hardware
NixOS can be installed on an increasing variety of hardware, including the usual x86-type hardware.
- A regular (Intel or AMD) desktop computer, laptop, or physically accessible server can follow the instructions in this page
- SBCs, like the Raspberry Pis, and other ARM boards can follow the instructions at NixOS on ARM
- Cloud and remote servers will find various instructions at NixOS friendly hosters
NixOS, as with most Linux-based operating systems, can be installed in different ways.
- The classic way, booting from the installation media (described in this page)
- Booting the media from an existing Linux installation
Making the installation media
Since NixOS 14.11 the installer ISO is hybrid. This means it is bootable on both CD and USB drives. It also boots on EFI systems, like most modern motherboards and apple systems. The following instructions will assume the standard way of copying the image to a USB drive. When using a CD or DVD, the usual methods to burn to disk should work with the iso.
"Burning" to USB drive
- Find the right device with
fdisk -l. Replace
/dev/sdXwith the proper device in the following steps.
- Burn with:
cp nixos-xxx.iso /dev/sdX
Writing the disk image with
dd also works.
- Find the right device with
diskutil list, let's say
- Unmount with
diskutil unmountDisk diskX.
- Burn with:
sudo dd if=path_to_nixos.iso of=/dev/diskX
- Download USBwriter.
- Start USBwriter.
- Choose the downloaded ISO as 'Source'
- Choose the USB drive as 'Target'
- Click 'Write'
- When USBwriter has finished writing, safely unplug the USB drive.
Alternative installation media instructions
The previous methods are the supported methods of making the USB installation media.
Those methods are also documented, they can allow using the USB drive to boot multiple distributions. This is not supported, your mileage may vary.
Booting the installation media
Since the installation media is hybrid, it will boot both in legacy bios mode and UEFI mode.
Whatever mode is used to boot the installation media, your motherboard or computer's configuration may need to be changed to allow booting from a Optical Disk Drive (for CD/DVD) or an external USB drive.
Legacy bios boot
This is the only boot possible on machines lacking EFI/UEFI.
The EFI bootloader of the installation media is not signed and is not using a signed shim to boot. This means that Secure Boot will need to be disabled to boot.
Connecting to the internet
The installation will definitely need a working internet connection. It is possible to install without one, but the available set of packages is limited.
For network interfaces supported by the kernel, DHCP resolution should already have happened once the shell is available.
Tethered (Internet Sharing)
If you can not connect to the internet via cable or wifi, you may use smartphone's tethering capability to share internet. Depending on your smartphones capabilities, only stock kernel drivers may be required which can help providing a working network connection.
Network Manager is installed, meaning that it is possible to use
nmtui on the command line to connect to a network.
If you are more familiar with
wpa_supplicant then you can also run
wpa_passphrase ESSID >/etc/wpa_supplicant.conf and
systemctl restart wpa_supplicant.
Additional notes for specific hardware
These are collected notes or links for specific hardware issues.
- Blog post how to install NixOS on a Dell 9560
- Brand servers may require extra kernel modules be included into initrd (boot.initrd.extraKernelModules in configuration.nix) For example HP Proliant needs "hpsa" module to see the disk drive.