diff --git a/README.md b/README.md
new file mode 100644
index 0000000..85fa297
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+Docker registry deployment and configuration
+===========
+
+This repository contains configuration for deploying a docker registry. 
+
+To use it, create a htpasswd file in `auth/registry.passwd`
+
+> mkdir auth
+> htpasswd -Bc auth/registry.password <username>
+
+You also need a configuration file in `conf/config.yml`.  Adapt the config template found in this repository to your needs.