diff --git a/README.rst b/README.rst
index 309604a..85246e6 100644
--- a/README.rst
+++ b/README.rst
@@ -3,19 +3,47 @@
 aodh
 ==================================
 
-Service aodh description
+Aodh is an alarming service for OpenStack. It used to be a part of Ceilometer, but starting from Mitaka it
+is a separate project. Aodh supports several types of alarms like threshold, event, composite and gnocchi-specific.
+In cluster mode, coordination is enabled via tooz with Redis backend.  
+MySQL is used as a data backend for alarms and alarm history.
 
 Sample pillars
 ==============
 
-Single aodh service
+Cluster aodh service
 
 .. code-block:: yaml
 
     aodh:
       server:
         enabled: true
-        version: icehouse
+        version: mitaka
+        ttl: 86400
+        cluster: true 
+      database:
+        engine: "mysql+pymysql"
+        host: 10.0.106.20
+        port: 3306
+        name: aodh
+        user: aodh
+        password: password
+      bind:
+        host: 10.0.106.20
+        port: 8042
+      identity:
+        engine: keystone
+        host: 10.0.106.20 
+        port: 35357
+        tenant: service
+        user: aodh
+        password: password 
+      message_queue:
+        engine: rabbitmq
+        port: 5672
+        user: openstack
+        password: password
+        virtual_host: '/openstack'
 
 
 Development and testing
@@ -56,7 +84,8 @@
 Read more
 =========
 
-* links
+* https://docs.openstack.org/cli-reference/aodh.html
+* https://docs.openstack.org/developer/aodh/
 
 Documentation and Bugs
 ======================
diff --git a/aodh/files/mitaka/aodh.conf.Debian b/aodh/files/mitaka/aodh.conf.Debian
index 4b7745b..ef20b06 100644
--- a/aodh/files/mitaka/aodh.conf.Debian
+++ b/aodh/files/mitaka/aodh.conf.Debian
@@ -339,7 +339,9 @@
 # per-deployment central agent and per-host compute agent won't do
 # workload partitioning and will only function correctly if a single
 # instance of that service is running. (string value)
-#backend_url = <None>
+{%- if server.coordination_backend is defined %}
+backend_url = {{ server.coordination_backend.url }}
+{%-  endif %}
 
 # Number of seconds between heartbeats for distributed coordination.
 # (floating point value)
@@ -872,4 +874,4 @@
 #insecure=false
 
 [notification]
-store_events = {{ server.notifications.store_events }}
\ No newline at end of file
+store_events = {{ server.notifications.store_events }}