UniFi - Controller FAQ


Overview


Click on the question that interests you to expand and collapse the answers. If you don't see the answer you are looking for, search in our other UniFi FAQ articles: UniFi - Getting Started FAQor let us know by clicking on the Send Feedback button at the bottom of this article.


Frequently Asked Questions


What are the current UniFi Controller software versions for the different release branches?

Release Branch Current Release
LTS Stable 5.6.39 
LTS Stable Candidate 5.6.40
Stable 5.8.30
Stable Candidate (Beta Blog) 5.9.26
Stable Candidate (Updates Blog) 5.8.30
Testing -
Unstable -

 

NOTE: Some of these versions are in beta. To sign up for the beta program and be able to access these, follow this article.

What are the recommended UniFi Controller versions for UniFi Hardware?

We recommend always running the latest UniFi Controller software version as well as the latest device firmware version. Our developers are constantly updating and improving features, so for best functionality always upgrade. If you wish to know what the minimum version you can use is to check your device's Quick Start Guide's Introduction section. Quick Start Guides can be found at the bottom of the product page, which can be accessed when navigating from the UBNT Products page. They can also be downloaded from UBNT Downloads

Does the UniFi Controller have to run at all times? What happens with the Guest Portal when the Controller is offline?

UniFi devices retain their running configuration post-adoption. The controller is not required to be running for the devices to forward traffic. If the controller is restarted it will not restart your access points or other devices. All configurations as well as your internet connectivity will continue working as usual, but you will lose anything running on the Controller directly instead of a device, for example, statistics, reporting and most importantly, the Guest Portal.

 

When the Guest Portal feature is enabled, the controller is functioning as a captive portal. When a UniFi access point (UAP) cannot reach the controller, it goes into "SELFRUN" state. In this state, it will not redirect guests to the portal since it is not reachable, so the UAP will automatically allow guests to use the network without redirecting. Moreover:

 

  1. The guest access policies will still be effective, along with the restricted subnets feature.
  2. The user group configuration associated with this WLAN will still be effective.
  3. When the Controller comes back online (and the UAP goes into MANAGED state), the Guest Portal redirection feature will restore automatically.

If you wish to configure the "SELFRUN" state, please see this article. If you would like to know more about setting up Guest Networks (including the Portal), please see: UniFi - Wireless Guest Network Setup.

Can I make the UniFi Controller update information more frequently? Where is the refresh button?

The controller's refresh button is hidden by default, but it can be added to the top toolbar, by enabling it in the Controller's Preferences. You'll be able to select between 15 seconds, 1 minute, 2 minute or 5 minutes update intervals. Or you could altogether eliminate automatic refreshing, by selecting "Never refresh" and only refreshing the controller manually. To configure these two settings:
  1. Click on the three dots on the upper, right-hand corner of the UniFi Controller's toolbar. Select Preferences.
  2. To add the refresh button refresh.png to your controller's top toolbar, switch on the Enable refresh button setting.
  3. To adjust the frequency of automatic refreshing, or disable it completely, use the drop-down of the Refresh rate setting.

 

Can I change the language of the UniFi Controller?

Yes! The UniFi Controller translation, as well as most other translations in UBNT are Community based. They're a team effort done by native speaking Community members who have volunteered to work on this project. If you are interested in collaborating with us, please sign up for beta access first by following this article: How To Sign Up for Early Access and then join us in the Translations forum where you can volunteer to the products that most interest you. If you find mistakes in translations, please let us know in this dedicated Community thread. To change the language of your Controller follow these steps:

 

  1. Click on the three dots on the upper, right-hand corner of the UniFi Controller's toolbar. Select Preferences.
  2. Select the language you prefer from the Language drop-down menu.
  3. Read the warning before clicking Save and Close, now visible in your selected language. Sometimes you will need to refresh the page to see the translations reflected on your screen. You can toggle to another section and back to force this refresh.
ATTENTION: All translations (other than English) are Community sourced, and should be considered to be in beta always. Before making any big changes, check the English translation first. Translations improve as they move forward; to get the best translations please upgrade to the newest Controller software version available.

I'm having trouble upgrading from an older UniFi Controller version, what can I do?

When upgrading, always read the Release Notes, there will be information on any considerations to keep in mind when migrating from previous versions. 

 

Upgrading from v2 to current version: There is no direct upgrade path from v2 to v4, or later releases. You first need to upgrade from v2 to v3 then from v3 to the current release. You can find the download links for 3.2.10 HERE. After upgrading to 3.2.10 please upgrade to the most recent version, since older versions might present some issues that are now fixed. See our current controller versions above.

 

Migrating from v3 to current version: There are many changes to APIs and it's not backward compatible. You may need to update the shell library (unifi_sh_api) and/or your customized portal/external portal code.

What Java / JRE version should I be using?

NOTE: Currently, Java version 9 is incompatible with the UniFi Controller. We are working towards this compatibility.

UniFi 5.8.2 Stable Release: Only Java 8 is supported. Java 9 is not yet supported.

UniFi 5.7.23 Previous Stable Release: As of 5.7.x, we only support Java 8, which is the current LTS (Long-Term Support) release as designated by Oracle, this version is recommended for all controller deployments.

How can I trigger a provision?

Whenever a configuration is modified within the UniFi Controller UI, it will be automatically detected and a provision will be triggered. However, if you are changing configurations by modifying the config.properties file, the Controller will not detect the change and you will have to manually instruct it to begin a provision.

 

To trigger a provision via the controller follow these steps:

  1. Launch the Controller and access the Devices section.
  2. Click on the device you wish to provision, displaying the Properties panel.
  3. Click on the Config tab.
  4. Click to expand the Manage Device section.
  5. Scroll down to the Force Provision section and click on the Provision button.

If you need to trigger a provision for all access points, perform it using the group config feature by doing the following:

  1. Launch the Controller and access the Devices section.
  2. In the top toolbar All will be selected by default. Click on APS.
  3. Click on the gear icon in the upper right hand corner and check the box for Enable group config. This will add a empty checkbox to AP row.group-config.png
  4. Check the top box to select all.
  5. Click the button of Edit Selected which appeared in the top toolbar. This expands a batch AP Properties panel.
  6. Go to Config > Manage Devices and click the Provision button. provision.png