- New host config: phantom-ship.nix (SSH, auto-rebuild, nix-ld, Ethernet) - Hardware stub: phantom-ship-hardware.nix (replaced by install script) - Add phantom-ship to flake.nix with home-manager - Install script now auto-provisions post-install: - Clones dotfiles to /etc/dotfiles - Installs SSH public key (SSH_PUBKEY_FILE env var) - Generates hardware config - Supports INSTALLER_HOSTNAME and INSTALLER_DISK env vars - Fix bootstrap-install.sh default branch to main - Update CLAUDE.md and server-installer-usb.md
3.4 KiB
CLAUDE.md
Build commands
# macOS (from ~/dotfiles/nixos)
darwin-rebuild switch --flake .
# NixOS servers (SSH from mac, or on server)
sudo nixos-rebuild switch --flake .#sunken-ship
sudo nixos-rebuild switch --flake .#phantom-ship
# WSL
sudo nixos-rebuild switch --flake ~/dotfiles/nixos#wsl
# Update flake + rebuild (fish alias: nixupdate)
cd ~/dotfiles/nixos && sudo nix flake update && sudo darwin-rebuild switch --flake ~/dotfiles/nixos#Daniel-Macbook-Air
# Installer ISO (Linux only, cannot build on macOS)
cd ~/dotfiles/nixos && nix build .#installer-iso
Rebuild protocol
Never run rebuild commands automatically. When changing Nix config files, always ask the user to rebuild first. Do not assume packages are available until after a successful rebuild.
Flake architecture
- Flake:
nixos/flake.nix— single flake for all hosts - Inputs: nixpkgs-unstable, nix-darwin, home-manager, nixos-wsl, disko, zen-browser
- Host configs in
nixos/hosts/:daniel-macbook-air.nix— hostnameDaniel-Macbook-Air(aarch64-darwin, nix-darwin)sunken-ship.nix— NixOS home server (x86_64-linux, WiFi + AirPlay)phantom-ship.nix— NixOS home server (x86_64-linux, Ethernet)wsl.nix— WSL (x86_64-linux)server-install.nix— disko-install target (LUKS)
- Home Manager: integrated on macOS, WSL, and sunken-ship; user config in
nixos/home/danny/home.nix - Shared modules:
nixos/fish.nix(fish + bash),nixos/ollama.nix - Darwin config name:
Daniel-Macbook-Air(must match in rebuild commands)
Repo rules
- Public repo — no keys, tokens, or identifying secrets. Use
scpor config outside the repo. - SSH keys: one key per purpose (e.g.
id_ed25519_github,id_ed25519_servers). UseIdentityFile+IdentitiesOnly yesin~/.ssh/config. Keys stay outside the repo. - Commit and push before testing on sunken-ship — the server clones/pulls from origin.
Server (sunken-ship)
- SSH:
ssh -i ~/.ssh/id_ed25519_sunken_ship danny@sunken-ship - Remote rebuild:
ssh ... 'cd /etc/dotfiles/nixos && sudo nixos-rebuild switch --flake .#sunken-ship' - Auto-rebuild timer:
dotfiles-rebuild— every 15 min. Check withsystemctl is-active dotfiles-rebuild.timer. - WiFi connected; stays reachable when ethernet is unplugged.
- Services: UxPlay (AirPlay receiver on Scarlett Solo)
Server (phantom-ship)
- SSH:
ssh danny@phantom-ship - Remote rebuild:
ssh ... 'cd /etc/dotfiles/nixos && sudo nixos-rebuild switch --flake .#phantom-ship' - Auto-rebuild timer: same pattern as sunken-ship.
- Ethernet only (no WiFi).
Ollama
Custom nix-darwin module at nixos/ollama.nix (upstream PR not yet merged). Enabled on macOS via nixos/hosts/daniel-macbook-air.nix. Runs as a launchd user agent with ollama serve.
Alacritty (macOS)
Terminal colors follow System Settings → Appearance: programs.alacritty imports ~/.config/alacritty/active-colors.toml; scripts/alacritty-sync-system-theme.sh copies Catppuccin latte/mocha there when the OS mode changes. nix-darwin launchd.user.agents.alacritty-system-theme polls every 30s; fish runs the same script on interactive startup. After changing Nix, one darwin-rebuild switch. Details: assets/alacritty/README.md.
Shell
Fish is the default shell. Bash auto-execs fish unless the parent process is already fish. Vi keybindings with fzf integration. Zoxide aliased to cd.