Skip to main content

Getting Started

Pick your desired operating system and follow the below instructions.



For a more automated way to install NixOS, see nixos-anywhere.

  1. Install NixOS
  2. Enable Flakes
  3. Flakify your /etc/nixos/configuration.nix:
  4. Convert your flake.nix to using nixos-flake using the NixOS only template as reference.

non-NixOS Linux

  1. Install Nix
  2. Use the HOME only template


  1. Install Nix
  2. Install nix-darwin
  3. Use the macOS only template1


  1. Alternatively, use the "Both platforms" template if you are sharing your configuration with the other platform as well.