info_i_25x25.png See important information about Ubiquiti Devices and KRACK Vulnerability in this article. We will update this document as more information becomes available.

airControl - How to Install airControl on Ubuntu Server

Overview


In this article users will learn how to install airControl on Ubuntu 14.04 LTS.  It is recommended to use the most recent x64 LTS (Long Term Support) release of Ubuntu.

info_i_25x25.png Note: in this article you will see mention of: aircontrol-latest-unix64.bin. Substitute this version with the latest version available to complete the install correctly. See our airControl Community forum for the latest releases.

Steps to Install airControl on Ubuntu


  1. Navigate to the airControl section: after logging into your UBNT account, please navigate to the airControl section located HERE.  You can find the most recent airControl release at the top.
  2. Log into your Ubuntu server via SSH or open a Terminal.
  3. Install the following dependencies:
     sudo apt-get install default-jdk iperf
  4. Download the most recent x64 release of airControl using wget.
    wget https://www.ubnt.com/downloads/aircontrol2/aircontrol-latest-unix64.bin
  1. Give the downloaded file execute permission. 
    chmod u+x aircontrol-latest-unix64.bin
  2. Run airControl install using sudo.
    sudo ./aircontrol-latest-unix64.bin

Follow the on-screen prompts.  You’ll be asked to pick an administrator username and password, along with the install location and port.  You can hit enter to accept the defaults.  You’ll also be asked to install and set a password for Postgres DB. Make sure to note this password for future recovery/backup/migrations.

  1. Install the airControl 2 client: after the installation is complete, you’ll need to install the airControl client for Windows/Linux/OSX to connect to your new airControl server. For a quick test to check the connection to the server is working properly, in a web browser on the client navigate to http://ip-of-ac2-server:9081/diag. You will then see diagnostic information for the airControl Server.

Related Articles