PDF(19.7 KB) View with Adobe Reader on a variety of devices
ePub(83.5 KB) View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
Mobi (Kindle)(70.8 KB) View on Kindle device or Kindle app on multiple devices
Updated:April 7, 2022
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This document helps customers to find the most reliable AireOS Wireless LAN Controller (WLC) software available. Cisco recommends AireOS builds from each train of released WLC software. These recommendations may be updated on a weekly basis.
Escalation Builds/Maintenance Interims
In some cases, the recommended release might be an escalation or maintenance interim/beta build. Such releases are not available on CCO (Cisco.com), but have important bug fixes (beyond what is available in CCO code), and will be operational in production at customer sites for several weeks.
Note that, in some cases, the beta/escalation/interim build will contain support for unreleased features and/or hardware. Cisco Technical Assistance Center (TAC) does not support unreleased features or hardware - until official release, such support will come from the Business Unit (BU).
For released features and platforms, these builds are fully supported by TAC and the BU.
In order to request a TAC recommended escalation/maintenance interim build, open a Cisco TAC case on your Wireless LAN Controller contract.
Recommended AireOS Builds
Cisco recommends AireOS 126.96.36.199 for all deployments with 802.11ac/802.11ax access points and 8540/5520/3504/vWLC controllers. 188.8.131.52 has fixes for the following widely encountered bugs:
CSCwa30802 stuck transmit queue on 2800/3800/4800/1562/IW6300 triggered by MU-MIMO load
CSCvz16800 AireOS can't receive M2 / ID-RESPONSE from MAC addresses with 0x888e in the middle two bytes
CSCvs77557 Cisco Aironet 3802 AP is not able to acknowledge EAP frames (EAP-TLS)
CSCvx98176 Access point with 17.6 image cannot join AireOS controller
AireOS 184.108.40.206 is a short-lived release with no maintenance planned - see the End of Life bulletin. Customers who require new features that are unavailable in 8.5 should run 8.10.
AireOS 220.127.116.11 is a short-lived release with no maintenance planned, and is deferred - see the End of Life bulletin. Customers who require new features that are unavailable in 8.5 should run 8.10.
AireOS 8.5 is End of Life; Cisco will release no more fixes for it. See the Product Bulletin. It's the last train for the following platforms: AP1600, AP2600, AP3500, AP3600, AP1552 (128MB version), AP802, WLC2504, WLC5508, WLC7510, WLC8510, WiSM2. AireOS 8.5 has two branches:
The 8.5 Mainline branch supports 5508/8510/5520/8540/3504/2504/7510/WiSM2/vWLC controllers. It supports intercontroller mobility (IRCM) between AireOS and old "New Mobility" ("Converged Access") controllers (5760/3850/3650.) It does not support IRCM with 9800 controllers. For 8.5 Mainline deployments, TAC recommends 18.104.22.168 or 8.5MR8 escalation (22.214.171.124, available now from TAC.)
Note: Access points with 17.6.1 or above loaded will be unable to join any controller running any AireOS released prior to July 2021. For 8.5 Mainline, this is fixed in 126.96.36.199. For more details, see CSCvx98176 .
Note: However, TAC does not recommend running 188.8.131.52 in production, in any deployment where the WLC has mobility peers, due to CSCvz84912, which can cause frequent unexpected reloads. Customers who need fixes that are in 184.108.40.206 should reach out to TAC for 220.127.116.11.
The 8.5 IRCM branch supports only 5508/8510/5520/8540/3504 controllers. It supports IRCM between AireOS and 9800 controllers; it does not support IRCM with old "New Mobility" controllers. For 8.5 IRCM deployments, TAC recommends 18.104.22.168; earlier 8.5 IRCM releases were 22.214.171.124, 126.96.36.199 and 188.8.131.52, and 184.108.40.206.
Note: Access points with 17.6.1 or above loaded will be unable to join any controller running any AireOS released prior to July 2021. For 8.5 IRCM, this is fixed in 220.127.116.11/18.104.22.168. For more details, see CSCvx98176.
For Mobility Express deployments, TAC recommends using the latest 8.10 release.
Always refer to the SDA Compatibility Matrix for code combination recommendations that work best for SDA. It lists specific combinations of code on Cisco DNA Center, the Identity Service Engine (ISE), switches, routers and Wireless LAN Controller codes that have been tested by the SDA Solution Test team at Cisco.