diff --git a/doc/admin-guide-cloud/networking/section_networking_config-agents.xml b/doc/admin-guide-cloud/networking/section_networking_config-agents.xml
index ea9b8b66a1..96d522334f 100644
--- a/doc/admin-guide-cloud/networking/section_networking_config-agents.xml
+++ b/doc/admin-guide-cloud/networking/section_networking_config-agents.xml
@@ -152,6 +152,12 @@
         </section>
         <section xml:id="install_neutron_agent_ryu">
             <title>Node set up: Ryu plug-in</title>
+            <warning>
+                <para>
+                    The Ryu plug-in is deprecated as of the Juno release and might be removed in Kilo
+                    or a subsequent release.
+                </para>
+            </warning>
             <para>If you use the Ryu plug-in, you must install
                 both Open vSwitch and Ryu, in addition to the Ryu
                 agent package.</para>
diff --git a/doc/admin-guide-cloud/networking/section_networking_config-plugins.xml b/doc/admin-guide-cloud/networking/section_networking_config-plugins.xml
index 5dafc8e173..99d39eb15d 100644
--- a/doc/admin-guide-cloud/networking/section_networking_config-plugins.xml
+++ b/doc/admin-guide-cloud/networking/section_networking_config-plugins.xml
@@ -319,6 +319,12 @@ password = "PLUMgrid-director-admin-password"</programlisting>
     </section>
     <section xml:id="ryu_plugin">
         <title>Configure Ryu plug-in</title>
+        <warning>
+            <para>
+                The Ryu plug-in is deprecated as of the Juno release and might be removed in Kilo or
+                a subsequent release.
+            </para>
+        </warning>
         <procedure>
             <title>To use the Ryu plug-in with OpenStack Networking</title>
             <step>
diff --git a/doc/networking-guide/section_architecture-plug-in.xml b/doc/networking-guide/section_architecture-plug-in.xml
index ebefc95dd3..e4adc9f7e0 100644
--- a/doc/networking-guide/section_architecture-plug-in.xml
+++ b/doc/networking-guide/section_architecture-plug-in.xml
@@ -35,7 +35,6 @@ ML2 (Modular Layer 2) Plug-in  https://wiki.openstack.org/wiki/Neutron/ML2
 NEC OpenFlow Plug-in  https://wiki.openstack.org/wiki/Neutron/NEC_OpenFlow_Plugin
 Open vSwitch Plug-in  This guide.
 PLUMgrid  This guide and https://https://wiki.openstack.org/wiki/PLUMgrid-Neutron
-Ryu Plug-in  This guide and https://github.com/osrg/ryu/wiki/OpenStack
 VMware NSX Plug-in  This guide and NSX Product Overview, NSX Product Support
 Plug-ins can have different properties for hardware requirements, features, performance, scale, or operator tools. Because Networking supports a large number of plug-ins, the cloud administrator can weigh options to decide on the right networking technology for the deployment.
 In the Havana release, OpenStack Networking introduces the Modular Layer 2 (ML2) plug-in that enables the use of multiple concurrent mechanism drivers. This capability aligns with the complex requirements typically found in large heterogeneous environments. It currently works with the existing Open vSwitch, Linux Bridge, and Hyper-v L2 agents. The ML2 framework simplifies the addition of support for new L2 technologies and reduces the effort that is required to add and maintain them compared to earlier large plug-ins.