diff --git a/readme.md b/readme.md
index 900550f5c..9bbb2cdbc 100644
--- a/readme.md
+++ b/readme.md
@@ -5,6 +5,14 @@
 
 see [getting started doc](https://github.com/threefoldfoundation/www_examplesite/blob/development/manual/install.md)
 
+
+### To run this website using Gitpod workspace :
+ - just make sure to install gitpod extension in your browser from [here](https://www.gitpod.io/docs/browser-extension/)
+ - to allow the website tap to be opened directrly in new tap at your browser after build , go to your browser setting and allow pop-up windows (optional).
+ - if you want to open mannualy and escaped the previous step , press ctrl button and click on that link ``` Site running at:         http://localhost:8080/  ``` .
+ - then you will find the website running in new tap. 
+
+
 ### contribute
 
 see [best practices](https://github.com/threefoldfoundation/www_examplesite/blob/development/manual/contribute.md)