Omada Hardware Controller_V5.12.9 (Released on Sep 19th, 2023)

This thread has been locked for further replies. You can start a new thread to share your ideas or ask questions.

Omada Hardware Controller_V5.12.9 (Released on Sep 19th, 2023)

This thread has been locked for further replies. You can start a new thread to share your ideas or ask questions.
Omada Hardware Controller_V5.12.9 (Released on Sep 19th, 2023)
Omada Hardware Controller_V5.12.9 (Released on Sep 19th, 2023)
2023-09-20 03:57:17 - last edited 2023-10-20 06:36:50

This Article Applies to


OC200(UN)_V1_1.26.3_Build 20230906 (Built-in Omada SDN Controller 5.12.9)

OC200(UN)_V2_2.11.3_Build 20230906 (Built-in Omada SDN Controller 5.12.9)

OC300(UN)_V1_1.19.3_Build 20230906 (Built-in Omada SDN Controller 5.12.9)


Release Notes


Notice: If you are using Web API, please take note that Cookie name has been changed from TPEAP_SESSIONID to TPOMADA_SESSIONID.


New Feature


1. Facebook Wi-Fi Removal: Due to changes implemented by Facebook, the Facebook Wi-Fi function has been removed.

2. Expanded Device Support: Added support for wireless router ER706W.

3. Managed Service Provider (MSP) Mode: The Omada Controller now (except the OC200 and OC300) includes an MSP mode, allowing you to monitor the overall status of your customers and manage customers within the Omada platform. To use this mode, enable it first in Global view > ⋮ icon in the top-right corner > Enable MSP mode, you can also disable it from the same location. In MSP mode, you could auto back up settings of all sites under one customer account.

4. Expanded Language Support: Added support for Deutsch, العربية, Polski, Čeština, Slovenčina and Magyar. Please note that the content of some pages has not yet been fully adapted to  العربية, and will be improved subsequently.

5. Open API: Omada Controller now supports Open API integration. You can access it through Global view > Settings > Platform Integration, which allows you to utilize the REST API of most Controller services. This feature enables you to develop custom applications, embed APIs, or combine your own applications. Refer to the Online API Document for guidance on usage, and view more by toggling the drop-down menu in the upper left corner.

6. Multi-language Voucher Code Print: Added support for printing voucher codes in multiple languages. You could choose your preferred language to be displayed on vouchers. The available language choices include English, Čeština, Deutsch, Français, Español, Nederlands, Italiano, Polski, Português, Русский, Türkçe, ﺔﻴﺑﺮﻌﻟا, 日本語, 中文(繁體), 한국어, Slovenčina and Magyar.

7. Intrusion Detection and Prevention System (IDS/IPS): IDS/IPS feature has been introduced to monitor network intrusions. Firmware update is required to use this feature. Once updated, you could access it in Site view > Settings > Network Security. Please refer to the release note of the device firmware for details on which Omada devices support this feature.

8. Port Schedule: Added support for schedules applied to ports of switch in Site View > Settings > Services > Port Schedule, allowing you to make schedule of when PoE or Port works for desired ports.

9. MAC Group Export: Added support for exporting MAC groups, making it easier to migrate MAC groups or edit MAC addresses.

10. Hotspot Operator Role: Added Role Admin/Viewer for Hotspot operator in Hotspot Manager, allowing you to assign write or read only privileges for different users according to demand.

11. Switch ACL Bingding with VLAN on Desired Switches: Added support for applying VLAN bound ACL to switches as your needs.

12. CHAP and LDAP in Portal: Added support for CHAP encryption in portal, allowing for secure authentication when used in conjunction with External Portal functionality; added support for LDAP (Lightweight Directory Access Protocol), enabling seamless integration with LDAP server for user authentication.

13. Account Permission Transfer: Added support for transferring account permissions. This feature is available in Global view > Account, and it allows you to change the Main Administrator account.

14. Multiple Upgrade Schedules: Added support for creating more schedules on upgrade plan.

15. Built-in RADIUS Server: A built-in RADIUS server has been added in Global > Settings > Server Settings, which can be used for WPA-Enterprise, Portal RADIUS Server and 802.1X.

16. Public IP Address Display: Remotely managed devices now show their public IP addresses in Devices > PUBLIC IP ADDRESS column.

17. Voucher Group and Voucher Statistics: Introduced Voucher Group and Voucher Statistics in the Hotspot Manager, which enables you to manage and monitor vouchers by group.

18. Omada Gateway New Features: Several new features have been made to the Omada Gateway, requiring firmware update:

  • IPv6 Support in Gateway ACL

You could now block IPv6 traffic through Gateway ACL settings.

  • IPv6 RA (Router Advertisement)

Added support to configure IPv6 RA for the Omada Gateway.

  • MAC Filtering

Added support for MAC filter in Site view > Settings > Network Security > MAC Filtering.

  • Session Limit Monitoring

Introduced support for monitoring session limits in Site view > Insight. This feature displays the number of sessions being used by a single IP address.

  • MSS Clamping

Added support for MSS (Maximum Segment Size) clamping in Site view > Settings > Wired Networks > Internet > PPPoE > Advanced Settings. MSS Clamping allows you to specify the upper limit for the value of the MSS field negotiated during TPC connection establishment, preventing IP fragmentation.

  • DNS Cache

Added support for DNS cache in Site view > Settings > Services. DNS cache improves domain name resolution speed by handling recent address resolutions locally before sending request to Internet.

  • Gateway Tools

Added Ping, Traceroute and Terminal tools to the Gateway.

  • Device Info Download

Introduced the ability to download device info of the Gateway. To access the feature, open the sidebar of Gateway, navigate to Config > Manage Device, and click Download. Omada Controller uses TCP port 29815 to receive device info.

  • IPsec Algorithm Enhancements

Added support for AES256, dh 14, dh 15 of IPsec algorithms.

  • IPsec Client-to Site VPN

Added support for IP range of local network when using IPsec for Client-to Site VPN.

  • Internet VLAN

Added support for tagging the same VLAN ID on different Internet networks.

  • WAN IP Alias

Added support for WAN IP Alias in Site view > Settings > Wired Networks > Internet. This feature allows you to configure multiple IP addresses on a single WAN port and use these IP addresses for port forwarding.

  • Location Group in Gateway ACL

Introduced Location Group support in Gateway ACL, allowing you to block data from or to specific locations.

  • Log Enhancements

Logs now show the source IP address of TCP no-Flag /ping of death attacks and changes in ISP network during link backup. Besides, added support for more logs of Gateway, which helps to manage and maintain the network.

  • Flow Control

Added support for Flow Control in Devices > Ports of Omada Gateways.

  • Custom Update Interval for DDNS

Added support for changing update interval of DDNS to 1~60 minutes.

19. Client Idle Threshold: Added the Client Idle Threshold option in Global view > Settings > Controller Settings. This allows you to specify the interval after which Omada Controller will claim a client is disconnected if it fails to report its status within that timeframe.

20. Map Enhancements: Added support for exportation of topology, Heat Map report and search box in Map. Added display of RSSI of EAP in Heat Map.

21. Release Note Display: You can now view release note directly in Omada Controller when clicking the device upgrade mark. This provides easier access to information about changes in new firmware versions.

22. Wireless Mode Configuration: Added support for changing the wireless mode of EAP in Devices > Config > Radios, which allows you to select the desired 802.11 mode for Omada EAP.

23. Device search in Statistics: Introduced the ability to search for devices in Statistics. This feature enables you to quickly find statistical results of specific devices.

24. Cloud Access Data Export: Added support for exporting data through cloud access.

25. System Logging level: Added support for changing System Logging level in Global view > Settings > System Settings. This feature facilitates debug log collection by allowing you to set the Logging Level Type to "custom" and select the desired debug level for the logs you need.




1. Site Limit: Expaneded the limit of sites to 5, 000.

2. Voucher Usage Calculation: Voucher now could calculate the usage time based on the user's actual online time.

3. AI WLAN optimization: Improved algorithm for better optimization results.

4. MAC Group: Added support for Add by Range when importing MAC address, which allows you to add multiple continuous MAC addresses through their range.
5. IP Address Input: Verification rule of input IP addresses has been updated to allow you to add legitimate IP address with 0 in the last segment.
6. Invitation E-mail: Added inviter username and Controller Name into e-mail body.
7. Client: Added support for showing SNR (Signal to Noise Ratio) in Clinet page.

8. Backup & Restore: Settings only backup will not include device information.

9. DHCP Reservation: Added support for search box and batch delete in DHCP reservation items, which helps you manage these items conveniently.

10. NTP Configuration: Moved NTP configuration from Global view to Site view, which makes you possible to manage sites with different timezones.

11. SMTP Server Location: Moved SMTP server from Global view > Settings > Controller Settings to Global view > Settings > Server Settings.

12. Alert E-mail: Added Controller and site name into title of alert e-mail.

13. Portal Profile Background: Background picture of portal profile could adapt to different screen sizes of laptops and mobiles.

14. Update Notification: Added choice of Controller/Device Update notification in Quick Setup process.

15. Client Page Illustration: Added illustration of icons in Clients Page, such as in Connection Type and Wireless Connection.




1. This version of the Controller is fully applied to the Omada APP of version 4.10 or above.

2. Omada SDN Controller can only manage certain devices running the supported firmware. Please confirm that your device is compatible with the SDN Controller.

3. For Windows OS, Java 8 (or OpenJDK-8) and above are required. How to install Java Runtime Environment (JRE) for Omada SDN Controller on Windows?

4. If you are upgrading from controller v3.x, it's highly recommended to upgrade 3.x to v4.1.5 first, then v4.1.5 to the latest 5.x. Please follow the Omada Controller Upgrade Guide in the installation package before upgrading.


Firmware Upgrade


Before the Upgrade

(1) For the sake of insurance, it's always recommended to save a copy of the controller Backup Config file before upgrade or downgrade.

(2) You may follow the following guide to upgrade your Omada Controller. How to Upgrade or Downgrade Omada SDN Controller


Firmware Download Link


  • Direct Download

     OC200(UN)_V1_1.26.3_Build 20230906    Full Release Note >

     OC200(UN)_V2_2.11.3_Build 20230906    Full Release Note > 

     OC300(UN)_V1_1.19.3_Build 20230906    Full Release Note >


  • Download From TP-Link Global "EN" Website:

     OC200 v1/v1.6:

     OC200 v2/v2.6:

     OC300 v1/v1.6:


Additional Information

If your Omada Hardware Controller get bricked during the firmware upgrade, you may follow the guide below to recover the firmware.

How to use the Recovery Mode to recover the firmware for Omada Hardware Controller


Any further questions or assistance needed with Omada SDN Controller, please feel free to contact TP-Link Tech Support by submitting a support ticket or connect with community by clicking Start a New Thread in the Business Community forums.


Recommended Threads


Get the Latest Omada SDN Controller Releases Here - Subscribe for Updates

Experience the Latest Omada EAP Firmware - Trial Available Here, Subscribe for Updates!

Get the Latest Firmware Releases for Omada Routers Here - Subscribe for Updates


>> Omada EAP Firmware Trial Available Here << *Try filtering posts on each forum by Label of [Early Access]*


Helpful: 1

Views: 2884

Replies: 0

Related Articles