diff --git a/README.md b/README.md
new file mode 100644
index 0000000..962a721
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+## Instructions on how to deploy the Beacon Network User Interface
+ 
+
+Please first create a .env file inside the frontend folder so that you can modify some variables as follows:
+
+```bash
+REACT_APP_CLIENT_ID="ID of your LS Login"
+REACT_APP_CLIENT_SECRET="password of your LS Login"
+```
+
+Take into account that the above file will not be copied to GitHub as it contains keys and for security reasons it should ignored.
+
+After that please proceed to execute the next command in order to deploy the UI.
+ 
+ ```bash
+docker-compose up -d –build
+```
+
+Then please edit the file config.json, which can be found inside folder [frontend/src](https://github.com/elixir-europe/beacon-network-ui/tree/main/frontend/src). You need to decide where you want the UI to point to when making requests. Find below an example:
+
+ ```bash
+{
+   "API_URL": "https://yourAPIdomain.com/beacon-network/v2.0.0",
+   "REDIRECT_URL": "https://yourUIdomain.com",
+   "KEYCLOAK_URL": "https://yourKEYCLOAKdomain.com"
+ }
+```
+
+In the root folder (frontend) you will find a file called .gitignore with the list of all files that need to be ignored.
diff --git a/docker-compose.yml b/docker-compose.yml
index 361e73f..1bbd501 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -11,4 +11,7 @@ services:
       - CHOKIDAR_USEPOLLING=true
     ports:
       - 3000:3000
-    stdin_open: true
\ No newline at end of file
+    stdin_open: true
+    volumes:
+      - ./frontend/.env:/frontend/.env
+      - ./frontend/src/config.json:/frontend/src/config.json
\ No newline at end of file
diff --git a/frontend/.gitignore b/frontend/.gitignore
index 532eddc..8027778 100644
--- a/frontend/.gitignore
+++ b/frontend/.gitignore
@@ -22,4 +22,6 @@ npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 
-.env
\ No newline at end of file
+.env
+
+*config.json
\ No newline at end of file