diff --git a/README.md b/README.md
index 911fcd10b3c80a2df301b0c43bd00498c2c7e39b..8f250fb78dc6f6c0375e392289519542e524b5c1 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,89 @@
 # Dojo Hepia
 
+## RUN ME - DojoHepia
+
+### prerequisites
+
+<p>MAVEN</p>
+<p>DOCKER</p>
+<p>DOCKER-COMPOSE</p>
+<p>ANGULAR CLI</p>
+
+#### Client
+
+>./client/
+```
+npm install
+ng serve --open
+```
+
+#### Gateway
+>./gateway/
+```
+mvn package
+mvn exec:java
+```
+
+#### Compilateur
+>./compilation/
+```
+mvn package
+mvn exec:java
+```
+
+##### Create java container
+
+>./compilation/docker/java
+```
+docker build . -t java:1.0
+```
+
+##### Create python container
+
+>./compilation/docker/python
+```
+docker build . -t python:1.0
+```
+
+#### MongoDB
+
+##### Create container
+
+>./mongodb/
+```
+docker-compose up -d
+```
+
+##### Create user
+
+>./mongodb/
+```
+docker-compose exec mongo mongo admin -u root
+password : example
+```
+
+insert the following command :
+
+```
+db.createUser(
+  {
+    user: "shodai",
+    pwd: "shodai",
+    roles: [
+       { role: "readWrite", db: "DojoHepia" }
+    ]
+  }
+)
+```
+
+##### Importing data
+<p>If you want to popularize the database with programs and katas, you can insert the following file in the mongo db database</p>
+
+>./mongodb/data/programs
+>./mongodb/data/programssubscription
+
+<p>to import </p>
+
 ## Vocabulaire
 | Art - Martial | Dojo Hepia       |
 |---------------|------------------|