fleet-pins/README.md

fleet-pins

Shared nixpkgs pin for the server fleet — ensures binary cache alignment

Overview

Centralized nixpkgs version pin shared by all servers in the fleet. Ensures consistent package versions and binary cache hits across armer, howard, emmett, micron, bim, and mermaid.

Design intent

All per-host pins (nixpkgs-armer, nixpkgs-emmett, etc.) currently follows = "nixpkgs" — there is zero divergence across the fleet today. This is intentional: a single shared revision maximises binary-cache hit rate and keeps the fleet in a known-good, consistent state.

The per-host inputs exist as named extension points so that any individual host can be broken away from the fleet default by changing its follows to a direct url. Until a host actually needs to diverge, the pins simply track the default.

Usage

Reference in your flake inputs:

inputs.fleet.url = "git+https://git.oleks.space/oleks/fleet-pins";

Then use fleet.inputs.nixpkgs as your nixpkgs source.