• Installation
• Usage
  • Managing Hosts
  • Rebuilding
  • Rollbacks
  • Keybindings
• Development Shells
• Credits

You can install on a running system or from the NixOS live installer. Get the minimal ISO from the NixOS website.

1. Clone the Repository:

git clone https://github.com/Sly-Harvey/NixOS.git ~/NixOS

2. Change Directory:

cd ~/NixOS

3. Run the Installer:

./install.sh

The install and rebuild scripts automate the setup process, including hosts, username, and applying the configuration. It also automatically generates the hardware-configuration.nix file based on your system's detected hardware, eliminating the need to manually generate it.

Method 1: Automatic - run the installer again to select or create another host:

./install.sh

Method 2: Manual:

1. Copy hosts/Default to a new directory (e.g., hosts/Laptop)

2. Edit the new host's variables.nix and host-packages.nix

3. Add the host to flake.nix:

   nixosConfigurations = {
     Default = mkHost "Default";
     Laptop = mkHost "Laptop";
   };

4. Track the new host with git:

   git add hosts/Laptop

5. Rebuild with the new hostname using either nixos-rebuild or nh (see Rebuilding below). Once rebuilt, you can use either the shortcut or rebuild command, as the host name will be implicitly recognised.

Apply configuration changes:

• Keyboard shortcut: Super + U
• rebuild script: rebuild
• nixos-rebuild: sudo nixos-rebuild switch --flake ~/NixOS#<HOST>
• nh: nh os switch --hostname <HOST>

Replace <HOST> with the name of your host (e.g., Laptop).

List generations:

list-gens

Rollback to generation N:

rollback N

Replace N with the generation number (e.g., 69).

View all keybindings with Super + ? or Super + Ctrl + K.

Pre-configured dev shells for various languages are included.

Initialize a project from a template:

nix flake init -t ~/NixOS#<TEMPLATE_NAME>

Or create a new project directory:

nix flake new -t ~/NixOS#<TEMPLATE_NAME> <PROJECT_NAME>

Templates are defined in dev-shells/default.nix (python, node, etc.).

Enter the shell:

cd <PROJECT_NAME>
nix develop

If you're using direnv, direnv allow can be used to activate the shell automatically when entering the directory.