diff --git a/doc/source/admin/deploy-lb-ha-vrrp.rst b/doc/source/admin/deploy-lb-ha-vrrp.rst
index 09f5153b1fd..b89b034bc35 100644
--- a/doc/source/admin/deploy-lb-ha-vrrp.rst
+++ b/doc/source/admin/deploy-lb-ha-vrrp.rst
@@ -96,6 +96,16 @@ Network node 2
       [securitygroup]
       firewall_driver = iptables
 
+   .. warning::
+
+      By default, Linux uses UDP port ``8472`` for VXLAN tunnel traffic. This
+      default value  doesn't follow the IANA standard, which assigned UDP port
+      ``4789`` for VXLAN communication. As a consequence, if this node is part
+      of a mixed deployment, where nodes with both OVS and Linux bridge must
+      communicate over VXLAN tunnels, it is recommended that a line containing
+      ``udp_dstport = 4789`` be added to the [vxlan] section of all the Linux
+      bridge agents. OVS follows the IANA standard.
+
    Replace ``PROVIDER_INTERFACE`` with the name of the underlying interface
    that handles provider networks. For example, ``eth1``.
 
diff --git a/doc/source/admin/deploy-lb-selfservice.rst b/doc/source/admin/deploy-lb-selfservice.rst
index ad535895e99..9ae19213313 100644
--- a/doc/source/admin/deploy-lb-selfservice.rst
+++ b/doc/source/admin/deploy-lb-selfservice.rst
@@ -124,6 +124,16 @@ Network node
       [securitygroup]
       firewall_driver = iptables
 
+   .. warning::
+
+      By default, Linux uses UDP port ``8472`` for VXLAN tunnel traffic. This
+      default value  doesn't follow the IANA standard, which assigned UDP port
+      ``4789`` for VXLAN communication. As a consequence, if this node is part
+      of a mixed deployment, where nodes with both OVS and Linux bridge must
+      communicate over VXLAN tunnels, it is recommended that a line containing
+      ``udp_dstport = 4789`` be added to the [vxlan] section of all the Linux
+      bridge agents. OVS follows the IANA standard.
+
    Replace ``PROVIDER_INTERFACE`` with the name of the underlying interface
    that handles provider networks. For example, ``eth1``.
 
@@ -161,6 +171,16 @@ Compute nodes
       l2_population = True
       local_ip = OVERLAY_INTERFACE_IP_ADDRESS
 
+   .. warning::
+
+      By default, Linux uses UDP port ``8472`` for VXLAN tunnel traffic. This
+      default value  doesn't follow the IANA standard, which assigned UDP port
+      ``4789`` for VXLAN communication. As a consequence, if this node is part
+      of a mixed deployment, where nodes with both OVS and Linux bridge must
+      communicate over VXLAN tunnels, it is recommended that a line containing
+      ``udp_dstport = 4789`` be added to the [vxlan] section of all the Linux
+      bridge agents. OVS follows the IANA standard.
+
    Replace ``OVERLAY_INTERFACE_IP_ADDRESS`` with the IP address of the
    interface that handles VXLAN overlays for self-service networks.