diff --git a/nix/README b/nix/README
new file mode 100644
index 0000000000000000000000000000000000000000..d4de15ba9c275f6882e3ed8fe5c597e312c27370
--- /dev/null
+++ b/nix/README
@@ -0,0 +1,8 @@
+This directory contains expressions for packaging PaymentServer on NixOS.
+The contents of this directory are almost entirely automatically generated by stack-to-nix.
+Editing them is probably a bad idea since it will make future automated updates more difficult.
+
+However, I did edit default.nix to replace the master tarball of haskell.nix with a particular revision.
+Read the comment there for details.
+
+See https://github.com/input-output-hk/haskell.nix for details of stack-to-nix.