Upcoming Maintenance Alert:

The UBNT Community will be upgraded at 5pm MDT on April 25th. During this time the community forums will be set to read-only status.

Learn more


UniFi 2.4.6 is released

by Ubiquiti Employee on ‎10-15-2013 02:01 PM - last edited on ‎07-21-2016 11:02 AM by Ubiquiti Employee (236,754 Views)

UniFi 2.4.6 is a stable/maintenance release. We will keep maintaining V2 until V3 is stable.

Release Note

  • Controller - relax email address checking.
  • Controller - fix double billing if clicked twice.
  • Controller - fix false error message when lauching controller - "Start up Failed, port 8080 is used by another program".
  • Controller - relax JRE requirement to 1.6.
  • Controller - fix navigation to payment.html page issue.
  • UAP-AC - backport v3 commits.
  • UAP-Outdoor+/UAP-AC Outdoor - add new AP model support.
  • UAP-PRO - stability improvements.

From 2.3.9->2.4.5

  • fix an issue (especially for UAP-Outdoor or Pico in high-interference environments) where AP stops accepting clients as their perceived signal drops
  • fix AP appears disconnected while still serving clients in certain environments
  • fix guests get redirected back to login page when controller's time differs from AP time
  • fix map uploading issue in some scenarios
  • fix 4th ssid with vlan not working issue
  • fix UAP-AC (US version) 5G radio issue introduced in 2.4.3
  • fix UAP-AC's 5G connectivity issue for newer Macbook Air with 11ac chip
  • fix Windows service launching issue with Java 7

How to perform the upgrade

For Debian-based system, simply do

sudo apt-get update
sudo apt-get install unifi


How to downgrade?


Make sure you have a backup of prior version. After downgrading the controller, you can downgrade the AP firmware.


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 Squeeze (6.0)
    deb http://www.ubnt.com/downloads/unifi/distros/deb/squeeze squeeze 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
    # or over HTTP. E.g. 'sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv C0A52C50'
    # for mongo-10gen
    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10
  3. update, install, and upgrade


    # retrieve the latest package information
    apt-get update
    # you can install / switch between them
    apt-get install unifi



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()