Build recipe for an unattended, offline capable USB-bootable NixOS installer to bootstrap random computers.
I typically use this to "transform" random computers to minimally setup NixOS machines by putting in my USB stick and boot from it. Afterward, the machine can be rebootet and then i can deploy whatever config i want over it from remote via SSH. The system is really just meant as a trampoline for installing "real" system configs from remote.
Warning: The created USB stick is destructive in the sense that it deletes everything on the disk without asking!
- Build the ISO image via
nix build ddthe ISO image over a USB stick- Put the USB stick into a machine that is set up to boot via USB
- Let the machine boot and wait until it powers off again. (It typically takes ~5 minutes)
- NixOS is now installed. Just SSH into it.
The installer partitions the disk like this:
- 512 MiB fat32 boot partition
- 8 GiB swap partition
- rest size ext4 nixos partition
The root user is the only user on the system. It has no password for physical login.
The only way to login is via SSH with pubkey authentication (see Customization in this README).
Unfree modules for wifi are added in order to enable the machine's wifi on first boot.
Only SSH is installed as a service.
Add your SSH key here
Add a wifi config to configuration.nix to let the machine automatically into your wifi after installation:
networking.wireless = {
enable = true;
networks."my-wifi-name".psk = "my-wifi-password";
userControlled.enable = true;
};There are different ways to add passwords to a machine, and this is not a secure one as the password will be stored in the nix store. (Which is fine for my purposes, but maybe not yours)