diff --git a/README.md b/README.md
index 4347b3c4..5b7f336a 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,17 @@
-### OpenRAG
+## OpenRAG
 
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/phact/openrag)
 
+### getting started
+
+Set up your secrets:
+
+    cp .env.example .env
+
+Populate the values in .env
+
+Run OpenRAG:
+
     docker compose build
 
     docker compose up