# nixos-configuration Personal NixOS configuration for all machines. Devices are declared in `devices.nix`, per-device configs live in `nixosConfigurations//`, and shared modules in `nixosModules/`. ## Distributed builds Machines are configured to act as build servers / binary caches for each other in devices.nix. ### Onboarding a device as a build client 1. Generate a key pair on the device: ```sh sudo ssh-keygen -t ed25519 -f /etc/nix/distributed-build-key -N "" -C "$(hostname)-nix-builds" && sudo cat /etc/nix/distributed-build-key.pub ``` 2. Add the public key to the device entry in `devices.nix`: ```nix distributedBuilds.clientPublicKey = "ssh-ed25519 AAAA... -nix-builds"; ``` 3. Rebuild all build machines so they pick up the new authorized key. ### Adding a build server 1. Add to its entry in `devices.nix`: ```nix distributedBuilds.isBuilder = true; distributedBuilds.hostPublicKey = "ssh-ed25519 AAAA..."; # from: ssh-keyscan -t ed25519 "$(hostname)" ``` 2. Generate a store signing key on the builder: ```sh sudo nix key generate-secret --key-name "$(hostname)" | sudo tee /etc/nix/signing-key.sec | sudo nix key convert-secret-to-public ``` 3. Add the printed public key to `devices.nix`: ```nix distributedBuilds.storeSigningPublicKey = ":"; ``` 4. Rebuild all machines so they trust the new signing key. ## agent-lab sandbox VM `agent-lab` is a throwaway NixOS VM on muede-pc2 for hyperhive agents to ssh into and apply risky configs to. The host (`nixosConfigurations/muede-pc2/agent-lab-vm.nix`) only seeds its disk and runs qemu — it never declares the guest's system, so the guest can `nixos-rebuild switch` itself freely. - Reachable at `muede-pc2:2222` (qemu user-mode NAT forward), root ssh only, authorized for the lpt2 and pc2 keys plus muede-pc2's build key. - `sudo agent-lab-reset [flake-ref]` rebuilds the seed image, replaces the disk, and restarts the VM. Takes seconds once the image is in the store. Defaults to the upstream flake; pass a local path to test uncommitted work. - `/etc/nix/netrc` is copied in over ssh on every VM start by `agent-lab-vm-netrc.service`, so the private cache credential stays out of the nix store. The host needs `/etc/nix/distributed-build-key` for this. - The guest's own config is `nixosConfigurations/agent-lab/`; it is the seed only. Whatever the agents switch to afterwards is not tracked here.