diff --git a/README.rst b/README.rst
index eec572b..f15f41e 100644
--- a/README.rst
+++ b/README.rst
@@ -1236,6 +1236,24 @@
          password: pswd
 
 
+Nova database connection setup:
+========
+
+.. code-block:: yaml
+
+   nova:
+     controller:
+     enabled: True
+     ...
+       min_pool_size: 100
+       max_pool_size: 700
+       max_overflow: 100
+       retry_interval: 5
+       max_retries: '-1'
+       db_max_retries: 3
+       db_retry_interval: 1
+       connection_debug: 10
+       pool_timeout: 120
 
 Upgrades
 ========