diff --git a/README.md b/README.md
index ce5ff4eb2..70199afb3 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,73 @@
+# Introduction
 
-Access your containers hostnames from everywhere
+A simple DNS Server proxy 
+
+# Running
+
+## Running localy
+
+Build the project 
+
+	npm install
+
+Starting the server 
+
+	npm start
+
+## Running on docker
+	
+	npm install # install dependencies
+	gradle build-dev # build docker image and run the container starting the app
+
+# Testing if DNS is working
+
+	$ host google.com 127.0.0.1
+	Using domain server:
+	Name: 127.0.0.1
+	Address: 127.0.0.1#53
+	Aliases:
+
+# Adding DNS entries
+
+you can edit `records.json` manually or use the **Gui Editor**
+
+# Gui editor
+
+the password is `cat`
+
+	http://<localhost or docker container ip>:5380/
+
+# Setting this proxy as default proxy 
+
+	sudo echo 'nameserver <127.0.0.1 or docker container ip>' > /etc/resolv.conf
+
+# A entry example
+
+records.json
+
+	[
+	  {
+	    "records": [
+	      {
+	        "type": "A",
+	        "address": "127.0.0.1",
+	        "ttl": 300,
+	        "name": "testing.mageddo.com"
+	      }
+	    ],
+	    "domain": "testing.mageddo.com"
+	  }
+	]
+
+testing on terminal 
+
+	$ host testing.mageddo.com 127.0.0.1
+	Using domain server:
+	Name: 127.0.0.1
+	Address: 127.0.0.1#53
+	Aliases: 
+
+	testing3.mageddo.com has address 127.0.0.1
+	testing3.mageddo.com has address 127.0.0.1
+	testing3.mageddo.com has address 127.0.0.1
 
-# status
-We are working to be it real
\ No newline at end of file