diff --git a/doc/source/install/keystone-install-obs.rst b/doc/source/install/keystone-install-obs.rst
index d88a58bee8..26d256b36e 100644
--- a/doc/source/install/keystone-install-obs.rst
+++ b/doc/source/install/keystone-install-obs.rst
@@ -125,6 +125,13 @@ Install and configure components
 
 5. Bootstrap the Identity service:
 
+   .. note::
+
+      Before the Queens release, keystone needed to be run on two separate ports to
+      accomodate the Identity v2 API which ran a separate admin-only service
+      commonly on port 35357. With the removal of the v2 API, keystone can be run
+      on the same port for all interfaces.
+
    .. code-block:: console
 
       # keystone-manage bootstrap --bootstrap-password ADMIN_PASS \
diff --git a/doc/source/install/keystone-install-ubuntu.rst b/doc/source/install/keystone-install-ubuntu.rst
index 491c96cd4b..d25cc59c00 100644
--- a/doc/source/install/keystone-install-ubuntu.rst
+++ b/doc/source/install/keystone-install-ubuntu.rst
@@ -118,6 +118,13 @@ Install and configure components
 
 5. Bootstrap the Identity service:
 
+   .. note::
+
+      Before the Queens release, keystone needed to be run on two separate ports to
+      accomodate the Identity v2 API which ran a separate admin-only service
+      commonly on port 35357. With the removal of the v2 API, keystone can be run
+      on the same port for all interfaces.
+
    .. code-block:: console
 
       # keystone-manage bootstrap --bootstrap-password ADMIN_PASS \