UniFi 4.2.0 is released

by Ubiquiti Employee ‎10-13-2014 09:03 AM - edited ‎01-15-2015 02:59 PM (51,474 Views)

This is an update public release of the UniFi controller which supports the Gateway product (USG) for the UniFi Product Line.


**This release does NOT support UniFi Switch (USW) or UniFi VoIP phones (UVP).**



  • This release supports APs and UniFi Security Gateway(USG).
  • This release is base on v3 AP software. Controller is v4
  • Can install this new or upgrade from v3.2.1/v3.2.5. Will not support upgrade from v2 to v4.

Change List 4.1.1 to 4.2.0

  • CTRL - Fixed Dashboard showing devices down when it is not.
  • CTRL - Add WLAN information to connected events.
  • CTRL - Change text on Wireless Guests to Guests.
  • CTRL - Correct Hotspot misspelling.
  • CTRL - Fixed error message in Guest Portal.
  • CTRL - Added popup box to state not to block client that is running the controller.
  • CTRL - Fixed some cases configuring USG does not apply the changes.
  • CTRL - Fixed wireless adoption failures.
  • CTRL - Added Speed test support when an USG is part of the network.
  • CTRL - Fixed changing timezone not updating the devices' timezone.
  • CTRL - Add Static IP to insights.
  • CTRL - Fixed UI hang in certain sequence.
  • CTRL - Improve on responsiveness on UI during searches or large databases.
  • CTRL - Fixed statistics sorting.
  • CTRL - Fixed WLAN User Group defaults to Default.
  • CTRL - Fixed WLAN default configurations.
  • CTRL - Updated statistics page.
  • CTRL - Add a space in the legacy selection area.
  • CTRL - Removed name limitation format for SSID in override section.
  • CTRL - Fixed inconsistency in AP WLAN Group configuration.
  • CTRL - Fixed AP in HT40 mode shown as HT20.
  • CTRL - Add WLAN scheduler support.
  • CTRL - Gracefully shutdown mongo database when existing on Linux platforms.
  • CTRL - Removed name limitation format for User Group.
  • CTRL - Fixed AP configuration tab sometimes is blank using IE browser.
  • CTRL - Fixed Events presentation is not correct in IE browser.
  • CTRL - Fixed search in rogue access point is limited to the name.
  • CTRL - Fixed event filtering responsiveness.
  • CTRL - Fixed time scope of events filtering consistency.
  • CTRL - Fixed traffic display not showing up properly in switching time periods.
  • CTRL - Client fixed IP should be disabled if no DHCP server(USG).
  • CTRL - Added Java 8 support.
  • CTRL - Fixed UAP LR showing up as 5Ghz supported.
  • CTRL - Loosen the restriction on how many recent events.
  • CTRL - Fixed install wizard adoption/selection was limited to one page.
  • CTRL - Fixed display issue in insights when flipping between tabs.
  • CTRL - Added notification when downloading a backup.
  • CTRL - Added block save if no changes are made in the Network section.
  • CTRL - Added email notification if admin email is changed.
  • CTRL - In Linux, generalize any AP only comments as wired devices are supported now.
  • CTRL - Fixed Win8+Firefox pull down menu from install wizard is chopped.
  • CTRL - Fixed map coverage related issues.
  • CTRL - Fixed event logs can be search by hostnames.
  • CTRL - Fixed blank alerts.
  • CTRL - APs are missing from the map after moving from one site to another.
  • CTRL - Map coverage does not get updated after changing TX power.
  • CTRL - Fixed AP placement shifted after changing scale.
  • CTRL - Fixed Event/Alert panel stop working after a few click.
  • CTRL - Fixed Last AP information missing from Insights.
  • CTRL - Fixed Past Guest Authoriations does not have hostname.
  • CTRL - Added items per page selection in Devices.
  • CTRL - Fixed auto populated was overwriting/covering some entry boxes.
  • CTRL - Updated Paypal portal scripts.
  • AP - Updated AP code to v3.2.5
  • USG - Can not provision 40 or more networks. 
  • USG - Implemented Speed test support.
  • USG - Fixed static hostname unifi cause stuck in disconnect state.
  • USG - Updated board name to UniFi naming.


How to perform the upgrade

We're being more cautious in pushing releases to the world. Following Google's model, we'll have three release channels

  • stable (widely used, most stable)
  • rapid (soaked in beta for a while)
  • beta (cutting edge)

For Debian-based system, simply do

sudo apt-get update
sudo apt-get install unifi-beta



How to play safe?

UniFi stores everything under <UNIFI_BASE>/data/ . Keeping a copy will get your base covered. You can even install the new version, stop it, copy the data/ over it, and restart the controller.


How to downgrade?

The DB schema is drastically different and downgrade is not possible. Make sure you have a backup of prior version. After downgrading the controller, you can downgrade the AP firmware.


Known Limitations

  • As stated in the NOTE above.
  • Hotspot upgrade is currently not supported. We be added to next release.



UniFi Controller APT howto

  1. edit /etc/apt/sources.list
    ## Ubuntu
    deb http://www.ubnt.com/downloads/unifi/distros/deb/ubuntu ubuntu ubiquiti
    # if you're using quantal (12.04) or after, you don't need this line
    deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen
    ## Debian Wheezy (7.0)
    deb http://www.ubnt.com/downloads/unifi/distros/deb/debian debian ubiquiti
    ## Debian Squeeze (6.0)
    deb http://www.ubnt.com/downloads/unifi/distros/deb/debian debian ubiquiti
    deb http://downloads-distro.mongodb.org/repo/debian-sysvinit dist 10gen
    ## Debian Lenny (5.0):
    deb http://www.ubnt.com/downloads/unifi/distros/deb/lenny lenny ubiquiti
    deb http://downloads-distro.mongodb.org/repo/debian-sysvinit dist 10gen
  2. add GPG Key
    # for Ubiquiti
    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv C0A52C50
    # for mongo-10gen
    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10
    # or over HTTP by using hkp://keyserver.ubuntu.com:80
  3. update, install, and upgrade
    # retrieve the latest package information
    apt-get update
    # install/upgrade unifi package
    # there are 3 packages in the same repository 
    # . unifi       (the most stable)
    # . unifi-rapid (soaked beta/rc/stable)
    # . unifi-beta  (the cutting edge)
    # you can install / switch between them
    apt-get install unifi-beta


A shell library, unifi_sh_api is provided with the release. here's a sample script to authorize a guest for 30 minutes

## define required variables
## include the API library
. unifi_sh_api
# authorize a client for 30 minutes, limit down/up speed to 2048/1024kbps, quota is 500MB
unifi_authorize_guest "e8:17:22:10:5d:4d" 30 down=2048 up=1024 bytes=500 
# generate 10 voucher(s) valid for 60 minutes, limit down/up speed to 2048/1024kbps, quota is 500MB
unifi_create_voucher 60 10 down=2048 up=1024 bytes=500
# this returns you a token that you can call by using unifi_get_vouchers()


  1. AP->Performance view is experimental. Currently it shows what the radio is doing by red (packets not sent because of likely interference) / yellow (packets retried) / green (packets sent)
  2. voucher.css and voucher.html, at data/sites/SITE_NAME/portal/bundle/, is where you can fully customize your voucher.
  3. If you have existing customized guest portal, make sure to change form="/guest/login" to form="login" - let the relative path take care of per-site URL
  4. For API access, you pretty much need to insert /s/SITENAME into the URL. (after login with an admin in for site)