NixOS Template

Flake-based NixOS template for VMs (x86_64-linux only).

 

Quick Start (Automated)

Boot the NixOS installer and run:

curl -sL https://raw.githubusercontent.com/Spokelax/nixos-template/main/install.sh | sudo bash

Supports unattended install with CLI options. Run with --help for details.

Default hostname is nixos-template (for Proxmox template creation). Override if installing directly.

 

Manual Install

For custom setups:

1. Partition - GPT with 512MB ESP + 1GB boot + root
2. Format - FAT32 EFI, ext4 boot, ext4 root
3. Mount - /mnt, /mnt/boot, /mnt/boot/efi
4. Clone - git clone https://github.com/Spokelax/nixos-template.git /mnt/etc/nixos
5. Hardware config - nixos-generate-config --show-hardware-config > /mnt/etc/nixos/hosts/hardware.nix
6. Host config - Create hosts/config.nix (see hosts/config.example.nix)

Tip

Default channel is nixos-unstable. To use stable, edit flake.nix before install: nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.11";

7. Install - nixos-install --flake /mnt/etc/nixos#hostname

 

After Install

See hosts/README.md for:

• Cloned VM setup (onboarding.sh)
• Host configuration
• Adding services