diff --git a/README.md b/README.md
index a2bf99edbbfb6d28182f49dbaf348ee628d95aa8..54bacefdaf977b5f69bff5641bb1b0db072a31a0 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,27 @@ with environment variables which will be injected in its container.
 
 ## Setup Workspace
 
-TODO
+* create directory:
+  ```
+  mkdir -p $GOPATH/src/code.vereign.com/gaiax/tsa/
+  ```
+* move in the previously created directory:
+  ```
+  cd $GOPATH/src/code.vereign.com/gaiax/tsa/
+  ```
+* clone the repository:
+  ```
+  git clone git@code.vereign.com:gaiax/tsa/workspace.git
+  ```
+* run the setup.sh script:
+  ```
+  ./setup.sh
+  ```
+* set the services you would like to use in the docker-compose.yml file, defaults is **infohub**
+* run docker compose:
+  ```
+  docker-compose up
+  ```
 
 ## 3rd Party Services