diff --git a/doc/source/install/install-obs.rst b/doc/source/install/install-obs.rst
index 99b9a7c40..c186cf18a 100644
--- a/doc/source/install/install-obs.rst
+++ b/doc/source/install/install-obs.rst
@@ -96,8 +96,8 @@ Install and configure components
         auth_url = http://controller:5000/v3
         memcached_servers = controller:11211
         auth_type = password
-        project_domain_name = default
-        user_domain_name = default
+        project_domain_name = Default
+        user_domain_name = Default
         project_name = service
         username = placement
         password = PLACEMENT_PASS
@@ -110,6 +110,11 @@ Install and configure components
         Comment out or remove any other options in the ``[keystone_authtoken]``
         section.
 
+     .. note::
+
+        The value of ``user_name``, ``password``, ``project_domain_name`` and
+        ``user_domain_name`` need to be in sync with your keystone config.
+
 #. Populate the ``placement`` database:
 
    .. code-block:: console
diff --git a/doc/source/install/install-rdo.rst b/doc/source/install/install-rdo.rst
index d71d8e65d..2cc27067f 100644
--- a/doc/source/install/install-rdo.rst
+++ b/doc/source/install/install-rdo.rst
@@ -87,8 +87,8 @@ Install and configure components
         auth_url = http://controller:5000/v3
         memcached_servers = controller:11211
         auth_type = password
-        project_domain_name = default
-        user_domain_name = default
+        project_domain_name = Default
+        user_domain_name = Default
         project_name = service
         username = placement
         password = PLACEMENT_PASS
@@ -101,6 +101,11 @@ Install and configure components
         Comment out or remove any other options in the ``[keystone_authtoken]``
         section.
 
+     .. note::
+
+        The value of ``user_name``, ``password``, ``project_domain_name`` and
+        ``user_domain_name`` need to be in sync with your keystone config.
+
 #. Populate the ``placement`` database:
 
    .. code-block:: console
diff --git a/doc/source/install/install-ubuntu.rst b/doc/source/install/install-ubuntu.rst
index 15cf258e6..c380c1106 100644
--- a/doc/source/install/install-ubuntu.rst
+++ b/doc/source/install/install-ubuntu.rst
@@ -87,8 +87,8 @@ Install and configure components
         auth_url = http://controller:5000/v3
         memcached_servers = controller:11211
         auth_type = password
-        project_domain_name = default
-        user_domain_name = default
+        project_domain_name = Default
+        user_domain_name = Default
         project_name = service
         username = placement
         password = PLACEMENT_PASS
@@ -101,6 +101,11 @@ Install and configure components
         Comment out or remove any other options in the ``[keystone_authtoken]``
         section.
 
+     .. note::
+
+        The value of ``user_name``, ``password``, ``project_domain_name`` and
+        ``user_domain_name`` need to be in sync with your keystone config.
+
 #. Populate the ``placement`` database:
 
    .. code-block:: console