Pearl1594 · Oct 7, 2026 · Oct 7, 2026 · Oct 14, 2026 · Oct 15, 2026 · Oct 21, 2026
diff --git a/source/_static/images/trunk-nic-associate-network-modal.png b/source/_static/images/trunk-nic-associate-network-modal.png
diff --git a/source/_static/images/trunk-nic-associate-network-nics-tab.png b/source/_static/images/trunk-nic-associate-network-nics-tab.png
diff --git a/source/_static/images/trunk-nic-disassociate-network.png b/source/_static/images/trunk-nic-disassociate-network.png
diff --git a/source/_static/images/trunk-nic-host-vlan-filtering-badge.png b/source/_static/images/trunk-nic-host-vlan-filtering-badge.png
diff --git a/source/_static/images/trunk-nic-migration-suitability-warning.png b/source/_static/images/trunk-nic-migration-suitability-warning.png
diff --git a/source/_static/images/trunk-nic-rule-ip-picker-grouping.png b/source/_static/images/trunk-nic-rule-ip-picker-grouping.png
diff --git a/source/_static/images/trunk-nic-vnf-nic-mappings.png b/source/_static/images/trunk-nic-vnf-nic-mappings.png
diff --git a/source/_static/images/trunk-nic-zone-readiness-capacity.png b/source/_static/images/trunk-nic-zone-readiness-capacity.png
diff --git a/source/adminguide/networking/multi_vlan_trunk_nics.rst b/source/adminguide/networking/multi_vlan_trunk_nics.rst
diff --git a/source/adminguide/networking_and_traffic.rst b/source/adminguide/networking_and_traffic.rst
@@ -33,6 +33,8 @@ providing networking features for guest traffic.
 
 .. include:: networking/multiple_guest_networks.rst
 
+.. include:: networking/multi_vlan_trunk_nics.rst
+
 .. include:: networking/dynamic_static_routing.rst
 
 .. include:: networking/network_permissions.rst

diff --git a/source/upgrading/upgrade/upgrade_notes.rst b/source/upgrading/upgrade/upgrade_notes.rst
@@ -17,6 +17,17 @@
 General Upgrade Notes
 =====================
 
+VLAN filtering on KVM guest bridges
+-----------------------------------
+
+A KVM host whose guest bridge has ``vlan_filtering=1`` is detected as
+VLAN-filtering ready after the upgrade to Apache CloudStack 24.0 or later,
+whether or not multi-VLAN trunk NICs are used. Before upgrading to 24.0 or
+later, check that
+``/sys/class/net/<guest bridge>/bridge/vlan_filtering`` is ``0`` on every KVM
+host, unless you intend to use the feature there. See
+:doc:`/adminguide/networking/multi_vlan_trunk_nics`.
+
 Java version upgraded to Java 17
 ---------------------------------