diff --git a/README.md b/README.md
index 24e18b2..b851b6b 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,27 @@
 # Mock SAML from BoxyHQ
+
+Mock SAML is a SAML 2.0 IdP.
+
+```
+git clone https://github.com/boxyhq/mock-saml.git
+```
+
+```
+cd mock-saml
+```
+
+```
+npm install
+```
+
+```
+cp .env.example .env
+```
+
+```
+npm run build
+```
+
+```
+npm run start
+```