diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5db2f93
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# 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.
+
+## Usage
+
+Reference in your flake inputs:
+
+```nix
+inputs.fleet.url = "git+https://git.oleks.space/oleks/fleet-pins";
+```
+
+Then use `fleet.inputs.nixpkgs` as your nixpkgs source.