diff --git a/README.md b/README.md
index defe9d9..f1f8018 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,16 @@ docker files and integrations
 
 # idhub
 
-use script `./idhub_build.sh` to rebuild it locally
+## build
+
+```sh
+# clone or get latest versions of repos
+./pull-repos.sh
+# rebuild idhub locally
+./idhub_build.sh
+```
+
+in production, use `./idhub_build.sh prod` to enable detaching
 
 TODO: incorporate to general docker compose