diff --git a/api-ref/source/conf.py b/api-ref/source/conf.py
index 18e755fbc4..fae969b6b7 100644
--- a/api-ref/source/conf.py
+++ b/api-ref/source/conf.py
@@ -25,10 +25,6 @@
 import os
 import sys
 
-import openstackdocstheme
-
-from octavia.version import version_info
-
 extensions = [
     'os_api_ref',
     'openstackdocstheme'
@@ -40,9 +36,8 @@ html_theme_options = {
     "sidebar_dropdown": "api_ref",
     "sidebar_mode": "toc"
 }
-repository_name = 'openstack/octavia'
-bug_project = '908'
-bug_tag = 'api-ref'
+openstackdocs_repo_name = 'openstack/octavia'
+openstackdocs_use_storyboard = True
 
 
 # If extensions (or modules to document with autodoc) are in another directory,
@@ -70,15 +65,6 @@ master_doc = 'index'
 # General information about the project.
 copyright = u'2017-present, OpenStack Foundation'
 
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The full version, including alpha/beta/rc tags.
-release = version_info.release_string()
-# The short X.Y version.
-version = version_info.version_string()
-
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 #
@@ -106,7 +92,7 @@ add_module_names = False
 show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = 'native'
 
 # -- Options for man page output ----------------------------------------------
 
@@ -187,14 +173,6 @@ htmlhelp_basename = 'octaviadoc'
 
 # -- Options for LaTeX output -------------------------------------------------
 
-pdf_theme_path = openstackdocstheme.get_pdf_theme_path('openstackdocs')
-openstack_logo = openstackdocstheme.get_theme_logo_path('openstackdocs')
-
-latex_custom_template = r"""
-\newcommand{\openstacklogo}{%s}
-\usepackage{%s}
-""" % (openstack_logo, pdf_theme_path)
-
 # The paper size ('letter' or 'a4').
 # latex_paper_size = 'letter'
 
diff --git a/doc/requirements.txt b/doc/requirements.txt
index ebc9d6e968..d7f98a2eaa 100644
--- a/doc/requirements.txt
+++ b/doc/requirements.txt
@@ -9,11 +9,11 @@ sphinxcontrib-blockdiag>=1.5.4 # BSD
 sphinxcontrib-nwdiag>=0.9.5 # BSD
 sphinxcontrib-seqdiag>=0.8.4 # BSD
 docutils>=0.11 # OSI-Approved Open Source, Public Domain
-sphinx!=1.6.6,!=1.6.7,!=2.1.0,>=1.6.2 # BSD
+sphinx>=2.0.0,!=2.1.0 # BSD
 graphviz!=0.5.0,>=0.4 # MIT License
-openstackdocstheme>=1.20.0 # Apache-2.0
+openstackdocstheme>=2.2.1 # Apache-2.0
 sadisplay>=0.4.8 # BSD
-reno>=2.5.0 # Apache-2.0
+reno>=3.1.0 # Apache-2.0
 sphinx-feature-classification>=0.2.0 # Apache-2.0
 
 # PDF Docs
diff --git a/doc/source/conf.py b/doc/source/conf.py
index ebb8f45371..ed2a88e918 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -87,16 +87,6 @@ master_doc = 'index'
 # General information about the project.
 copyright = u'2014-2019, OpenStack Octavia Team'
 
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# Version info
-from octavia.version import version_info as octavia_version
-release = octavia_version.release_string()
-# The short X.Y version.
-version = octavia_version.version_string()
-
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 # language = None
@@ -131,7 +121,7 @@ add_module_names = False
 show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = 'native'
 
 # A list of ignored prefixes for module index sorting.
 modindex_common_prefix = ['octavia.']
@@ -348,9 +338,10 @@ epub_copyright = u'2014, OpenStack Octavia Team'
 policy_generator_config_file = '../../etc/policy/octavia-policy-generator.conf'
 sample_policy_basename = 'configuration/_static/octavia'
 
-repository_name = 'openstack/octavia'
-bug_project = '908'
-bug_tag = 'docs'
+openstackdocs_repo_name = 'openstack/octavia'
+openstackdocs_pdf_link = True
+openstackdocs_bug_project = '908'
+openstackdocs_bug_tag = 'docs'
 
 apidoc_output_dir = 'contributor/modules'
 apidoc_module_dir = '../../octavia'
diff --git a/lower-constraints.txt b/lower-constraints.txt
index 8188549cf9..3efd59aa1b 100644
--- a/lower-constraints.txt
+++ b/lower-constraints.txt
@@ -145,7 +145,7 @@ simplejson==3.13.2
 six==1.10.0
 smmap2==2.0.3
 snowballstemmer==1.2.1
-Sphinx==1.6.2
+Sphinx==2.0.0
 sphinxcontrib-svg2pdfconverter==0.1.0
 sphinxcontrib-websupport==1.0.1
 SQLAlchemy==1.0.10
diff --git a/releasenotes/source/conf.py b/releasenotes/source/conf.py
index 239aedb478..96052eff28 100644
--- a/releasenotes/source/conf.py
+++ b/releasenotes/source/conf.py
@@ -43,9 +43,9 @@ extensions = [
 ]
 
 # openstackdocstheme options
-repository_name = 'openstack/octavia'
-bug_project = '908'
-bug_tag = 'doc'
+openstackdocs_repo_name = 'openstack/octavia'
+openstackdocs_bug_project = '908'
+openstackdocs_bug_tag = 'doc'
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
@@ -95,7 +95,7 @@ exclude_patterns = []
 # show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = 'native'
 
 # A list of ignored prefixes for module index sorting.
 # modindex_common_prefix = []
diff --git a/test-requirements.txt b/test-requirements.txt
index 7d8277649e..9231bb60f5 100644
--- a/test-requirements.txt
+++ b/test-requirements.txt
@@ -17,5 +17,5 @@ doc8>=0.6.0 # Apache-2.0
 bandit!=1.6.0,>=1.1.0 # Apache-2.0
 tempest>=17.1.0 # Apache-2.0
 # Required for pep8 - doc8 tests
-sphinx!=1.6.6,!=1.6.7,>=1.6.2 # BSD
+sphinx>=2.0.0,!=2.1.0 # BSD
 bashate>=0.5.1 # Apache-2.0