diff --git a/Dockerfile b/Dockerfile
index 3f9e46f..e81bb1d 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,10 +1,6 @@
 FROM jboss/keycloak:4.4.0.Final
 MAINTAINER aaraujo@protonmail.ch
 
-ENV KEYCLOAK_USER democracyos
-ENV KEYCLOAK_PASSWORD democracyos
-ENV KEYCLOAK_WELCOME_THEME democracyos
-
 COPY democracyos /opt/jboss/keycloak/themes/democracyos
 COPY customization/standalone.xml /opt/jboss/keycloak/standalone/configuration/
 COPY customization/standalone-ha.xml /opt/jboss/keycloak/standalone/configuration/
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..85c598e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,44 @@
+# DemocracyOS Docker Keycloak Image
+This is [DemocracyOS](http://democracyos.org/) official [Keycloak](https://www.keycloak.org/) Docker image for development. It's based on [Keycloak Official Docker Image](https://hub.docker.com/r/jboss/keycloak/), starting with 4.4.0.Final version.
+
+## Quickstart
+---
+### Pull this image
+```bash
+$ sudo docker pull democracyos/keycloak:4.4.0
+```
+
+### Start keycloak
+```bash
+$ sudo docker run -d --name keycloak \
+                  -p 8080:8080 \
+                  -e "KEYCLOAK_USER=democracyos" \
+                  -e "KEYCLOAK_PASSWORD=democracyos" \
+                  -e "KEYCLOAK_WELCOME_THEME=democracyos" \
+                  democracyos/keycloak
+```
+
+### Access Keycloak
+Browse to http://localhost:8080 and go to Administration Console.
+![Keycloak landing](https://raw.githubusercontent.com/DemocracyOS/keycloak/master/img/kc_1.png)
+
+Login with user: democracyos and password: democracyos.
+![Keycloak login](https://raw.githubusercontent.com/DemocracyOS/keycloak/master/img/kc_2.png)
+
+Set DemocracyOS theme
+![Keycloak theme configuration](https://raw.githubusercontent.com/DemocracyOS/keycloak/master/img/kc_3.png)
+
+
+## Customize DemocracyOS theme
+---
+Themes are built with [Apache FreeMarker](https://freemarker.apache.org/). This keycloak docker installation is configured to instantly reflect changes in theme files for development purposes. More on this in the [Official Documentation](https://www.keycloak.org/docs/4.4/server_development/index.html#_themes).
+
+### Docker Image files
+DemocracyOS theme files are inside `democracyos/` directory while custom configurations reside in `customization` directory. All content is copied during docker build.
+
+## Docker Environment Variables
+As seen in _Start Keycloak_ section, some variables are needed to bootstrap Keycloak. As this is an extension of the official Docker image we recommend reading through the [Official Docker Image Documentation](https://hub.docker.com/r/jboss/keycloak/). Variables shown here are:
+
+* `KEYCLOAK_USER`: set keycloak admin user. There's no default value, if it is not set then direct access to container shell is needed to use [kcadm](https://www.keycloak.org/docs/4.4/server_admin/#the-admin-cli).
+* `KEYCLOAK_PASSWORD`: set keycloak admin user password. There's no default value, if it is not set then direct access to container shell is needed to use [kcadm](https://www.keycloak.org/docs/4.4/server_admin/#the-admin-cli).
+* `KEYCLOAK_WELCOME_THEME`: specify the theme to use for welcome page (must be non empty and must match an existing theme name).
\ No newline at end of file