Adding a New Host

Adding a host requires no flake.nix editing. Drop a directory into the right place and it’s auto-discovered.

Quick Way (mise task)

From any machine with mise installed:

mise run add-host <hostname> [os] [arch]

os accepts darwin or linux (defaults to current machine)
arch accepts aarch64 or x86_64 (defaults to current machine)

This creates the host directory from the appropriate template, generates user.nix from git config, creates a feature branch host/<hostname>, and commits.

Manual Way

macOS Host

mkdir -p hosts/aarch64-darwin/<hostname>
cp templates/darwin/* hosts/aarch64-darwin/<hostname>/

Edit user.nix with the machine’s identity fields:

{
  username = "jdoe";
  fullname = "Jane Doe";
  useremail = "jdoe@example.com";
  githubUsername = "jdoe";
}

Linux Host

mkdir -p systems/x86_64-linux/<hostname>
cp templates/linux/* systems/x86_64-linux/<hostname>/

Edit user.nix the same way.

Testing

After creating the host directory:

# macOS -- build without activating
nix build --accept-flake-config .#darwinConfigurations.<hostname>.system

# Linux system-manager
nix build --accept-flake-config .#systemConfigs.<hostname>

# Linux home-manager
nix build --accept-flake-config .#homeConfigurations.<hostname>.activationPackage

Activating

On the target machine:

# macOS
sudo darwin-rebuild switch --flake .

# Linux
sudo system-manager switch --flake .
home-manager switch --flake .#<hostname>

Or use the mise tasks which handle platform detection:

mise run nix:switch

Keyboard shortcuts