diff --git a/README.rst b/README.rst
index 824019f..a3a507c 100644
--- a/README.rst
+++ b/README.rst
@@ -844,6 +844,7 @@
             secret_key: secret
 
 Cinder service supports to define iscsi_helper for lvm backend.
+=======
 
 .. code-block:: yaml
 
@@ -870,6 +871,30 @@
       controller:
         ...
         scheduler_default_filters: (filters)
+=======
+
+* Cinder database connection setup:
+
+.. code-block:: yaml
+
+    cinder:
+      controller:
+        enabled: True
+        ...
+        database:
+          idle_timeout: 280
+          max_pool_size: 30
+          max_retries: '-1'
+          max_overflow: 40
+      volume:
+        enabled: True
+        ...
+        database:
+          idle_timeout: 280
+          max_pool_size: 30
+          max_retries: '-1'
+          max_overflow: 40
+
 
 Upgrades
 ========