Runbook: First Bring-Up

Status: living

Use this when the target machine already runs NixOS or can build/switch from the repo.

Primary checklist:

• ../first-bring-up-checklist.md

Success Criteria

• nixos-rebuild build --flake .#workstation succeeds.
• nixos-rebuild switch --flake .#workstation succeeds.
• configctl doctor succeeds.
• mode status, mode current, and mode desired work.
• /run/mode-controller exists and contains live state files.
• desktop.target and compute.target exist.
• vLLM is inactive in desktop.
• studio-local can be requested and removed as a desktop overlay.

Immediate Failure Buckets

• generated hardware configuration does not match the host
• NVIDIA/CUDA evaluation or runtime issue
• graphical target/session mismatch
• mode controller tools not installed
• observer reports false success or conflicting state

If mode state looks wrong, prefer fixing observation before adding transition logic.