diff --git a/README.md b/README.md
index b0c4e20..b9fb426 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,56 @@
 # Airavata Custos Portal
 
-## How to use
+## Getting started with running locally
 
-Airavat custos portal is available as a python package to install and customise for tenants needs.
-The forllowing instructions are for setting up a customised portal using all the features available
-in the airavata custos portal.
+### .env file
+
+Assuming you are running Custos locally (see
+https://github.com/apache/airavata-custos/tree/develop#quickstart), edit the
+.env file to match the client id and secret generated by the Custos bootstrap
+service:
+
+```
+CUSTOS_CLIENT_ID="custos-s8qf9g3odbbcdsgd2khv-10000000"
+CUSTOS_CLIENT_SEC="..."
+CUSTOS_API_URL="http://localhost:10000"
+CUSTOS_SUPER_CLIENT_ID="custos-s8qf9g3odbbcdsgd2khv-10000000"
+```
+
+### Running the frontend
+
+You need Node.js 14 and Yarn 1 installed.
+
+```
+yarn install
+yarn run serve
+```
+
+### Running the Django server
+
+You need Python 3.9+.
+
+```
+python -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+./manage.py migrate
+./manage.py runserver
+```
+
+## How to use as a Django app
+
+Airavat custos portal is available as a python package to install and customise
+for tenants needs. The forllowing instructions are for setting up a customised
+portal using all the features available in the airavata custos portal.
 
 1. Install
+
 ```
 pip install airavata-custos-portal
 ```
 
 2. Create a Django app
+
 ```
 django-admin startproject my_first_custos_app .
 cd my_first_custos_app
@@ -23,7 +62,7 @@
 3. Include the custos portal api and frontend in the urls.
 
 ```
-# my_first_custos_app/apps/frontend/urls.py 
+# my_first_custos_app/apps/frontend/urls.py
 
 from django.contrib import admin
 from django.urls import path
@@ -39,7 +78,7 @@
 4. Also, include the custom UI app in the urls.
 
 ```
-# my_first_custos_app/apps/frontend/urls.py 
+# my_first_custos_app/apps/frontend/urls.py
 
 from django.contrib import admin
 from django.urls import path
@@ -55,8 +94,8 @@
 
 ## Development
 
-The application consists of a Vue.js frontend and a Django based backend. 
-The instructions below are for setting up the local setup for development.
+The application consists of a Vue.js frontend and a Django based backend. The
+instructions below are for setting up the local setup for development.
 
 ### Change the configurations
 
@@ -81,7 +120,6 @@
 python -m venv venv
 source venv/bin/activate
 pip install -r requirements.txt
-cd airavata_custos_portal/
 ./manage.py migrate
 ./manage.py runserver
 ```
@@ -91,6 +129,7 @@
 ## How to publish
 
 1. Build the static files
+
 ```
 yarn build
 ```
@@ -102,7 +141,8 @@
 python -m build
 ```
 
-3. Publish the python package to pypi.org. Optionally can push to test.pypi.org. See https://packaging.python.org/tutorials/packaging-projects/ for more info.
+3. Publish the python package to pypi.org. Optionally can push to test.pypi.org.
+   See https://packaging.python.org/tutorials/packaging-projects/ for more info.
 
 ```
 python -m pip install --upgrade twine