diff --git a/README.md b/README.md
index 4aed2e9899344989d08374d004886424c307fa9b..af90c67a03b74158db095ea097619d42b1e4ee99 100644
--- a/README.md
+++ b/README.md
@@ -87,16 +87,17 @@ security:
   # make sure to share this amongst different pods
   tokenSigningKey: thisisasessionkeyreplacethisjetzt
 ```
-## Local tests
+## Testing locally
+A convenience docker-compose allows you to test the RDPGW locally. It uses [Keycloak](http://www.keycloak.org) 
+and [xrdp](http://www.xrdp.org) and exposes it services on port 443. You will need to allow your browser
+to connect to localhost with and self signed security certificate. For chrome set `chrome://flags/#allow-insecure-localhost`.
+The username to login to both Keycloak and xrdp is `admin` as is the password.
+
 ```bash
 cd dev/docker
 docker-compose build
 docker-compose up
 ```
-Allow your browser to run on unsecure localhost.
-For chrome
-chrome://flags/#allow-insecure-localhost
-Use admin:admin user password combination whenever asked.
 
 ## Use
 Point your browser to `https://your-gateway/connect`. After authentication