diff --git a/.gitignore b/.gitignore
index b4a5fb20f6..2aeb6ead31 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,3 +5,4 @@ lerna-debug.log
 
 .eslintcache
 
+.idea
\ No newline at end of file
diff --git a/integration-tests/README.md b/integration-tests/README.md
new file mode 100644
index 0000000000..af8cbfe1fe
--- /dev/null
+++ b/integration-tests/README.md
@@ -0,0 +1,14 @@
+# Integration-tests
+
+To be able to run the integration tests on your local machine, 
+run the following commands (adapted to your machine)
+
+```bash
+cd [ROOT_OF_YOUR_REPO]
+medusa-dev -p [YOUR_ABSOLUTE_PATH_TO_THE_REPO]
+npm run bootstrap
+cd integration-tests/api
+medusa-dev -s
+npm run build
+cd - && npm run test:integration
+```
\ No newline at end of file