Disabling WMM on Ubiquiti UniFi UAPs
My home network runs exclusively on Ubiquiti UniFi hardware which is fantastic, but it hides the WMM configuration setting from the web-based UI. Disabling Airtime Fairness and WMM is one of the first things you should do for any SSID dedicated to low-powered IoT devices like LIFX smart bulbs.
- Upgrade to the latest stable UniFi firmware
- Enable Advanced Features in the UniFi Network Controller
- Add SSH Keys to your UniFi Devices.
This procedure will disable WMM on the
IoT network only and leave it enabled on all other SSIDs.
Connect via SSH to the UAP and run the following command:
1 2 3
$ fgrep IoT /tmp/running.cfg aaa.1.ssid=IoT wireless.1.ssid=IoT
Make a note of the value of the line that begins with the word
wireless. In this example, it’s
Connect via SSH to your UniFi Controller and create a
config.propertiesfile in the correct site folder
config.propertiesfile. This will disable WMM on the
IoTSSID (identified by
wireless.1) on all APs. If you want to disable WMM on multiple SSIDs, you need to increment the first integer, i.e. the second line should be
config.system_cfg.2=...and so on.
Force provision all UAPs so they pick up the site-wide configuration.
Connect via SSH and check the configuration has been applied:
1 2 3 4 5 6 7
$ fgrep wmm /tmp/running.cfg wireless.1.wmm=enabled wireless.2.wmm=enabled wireless.3.wmm=enabled wireless.4.wmm=enabled wireless.5.wmm=enabled wireless.1.wmm=disabled
You’ll see that UniFi enables WMM by default across all SSIDs but the last line disables it specifically for the