diff --git a/doc/source/conf.py b/doc/source/conf.py
index aec93525..7b14fdbf 100755
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -22,6 +22,7 @@ sys.path.insert(0, os.path.abspath('../..'))
 extensions = [
     'sphinx.ext.autodoc',
     #'sphinx.ext.intersphinx',
+    'oslo_config.sphinxext',
     'oslosphinx'
 ]
 
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 2be70ddf..8eefaab3 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -9,6 +9,7 @@ to different database backends and various other helper utils.
    :maxdepth: 2
 
    installation
+   opts
    usage
    contributing
    history
diff --git a/doc/source/opts.rst b/doc/source/opts.rst
new file mode 100644
index 00000000..aa6f145f
--- /dev/null
+++ b/doc/source/opts.rst
@@ -0,0 +1,9 @@
+=====================
+Configuration Options
+=====================
+
+oslo.db uses oslo.config to define and manage configuration
+options to allow the deployer to control how an application uses the
+underlying database.
+
+.. show-options:: oslo.db