nixos/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Deploy

From within this directory:

sudo nixos-rebuild switch --flake .

To update flake inputs first:

nix flake update
sudo nixos-rebuild switch --flake .

To build without switching (dry run / check):

nixos-rebuild build --flake .#<hostname>
nix flake check

To deploy to a remote host:

nixos-rebuild switch --flake . --target-host <hostname>.local --sudo

To list generations:

nixos-rebuild list-generations

Architecture

This is a NixOS flake repository managing 5 hosts with shared Home Manager configuration.

Entry point: flake.nix — defines all host configurations via nixosConfigurations. A shared mkHomeManagerConfig helper wires Home Manager into each host. The inputs are passed as specialArgs so all modules can access them.

Two layers of configuration:

• hosts/ — system-level (NixOS modules, hardware, services)

  • hosts/modules/ — reusable system modules (base.nix, desktop.nix, laptop.nix, server.nix, personal.nix, sway.nix, niri.nix, etc.)
  • hosts/<name>/configuration.nix — host-specific config that imports from hosts/modules/

• alex/ — user-level (Home Manager modules)

  • alex/core.nix — base for all hosts (shell, git, tools, starship, fish, neovim)
  • alex/desktop.nix, alex/personal.nix — conditionally included per host

Hosts:

Host	Type	Notable
case	Laptop	WireGuard, ZeroTier, Syncthing, Sway/Niri
count	Desktop	AMD GPU + ROCm, Ollama
armitage	Laptop	systemd-boot, latest kernel
alt	Proxmox LXC	Media server (Jellyfin, *arr stack, Caddy)
nightcity	Proxmox LXC	Minimal server

Theme: Catppuccin Mocha (alex/colours/catppuchin-mocha.nix)

Stable channel: nixpkgs 25.11. Unstable packages are selectively overlaid via the nixpkgs-unstable input passed through specialArgs.