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
EOL Product Support 5.6.42 
Stable 5.12.22
Stable Candidate -
Unstable 5.12.5
Testing -

 

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

What are the recommended UniFi Network Controller versions for UniFi Hardware?

We recommend always running the latest UniFi Network Controller software version as well as the latest device firmware version provided in our Downloads page. Our developers are constantly updating and improving features, so for best functionality always upgrade. To know which is the latest recommended version for a specific device, go to the Downloads page, click on the model of choice in the left hand menu and look at the Software and Firmware sections. For example, notice that for the UAP-AC and the UAP-AC-Outdoor it is suggested to stay in the 5.6.42 software controller version.

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 UI Products page. They can also be downloaded from UI 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, manually applied user groups, 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 - Guest Network, Guest Portal and Hotspot System.

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 Ubiquiti 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 tag UI-AlexCaldas to volunteer. 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 v5 current releases. You first need to upgrade from v2 to v3 then from v3 to a newer version. There should be virtually no installs running v2 or earlier but if you fall into this category please reach out to support and we will happily provide you with a v3 release as an intermediary upgrade to help you get your site onto something current.

 

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?

UniFi 5.11.39 Stable Release: Java 8 must be installed on the system hosting the controller software. Java 9 and later are not yet supported.

UniFi 5.6.42 LTS Stable Release: Java 8 must be installed on the system hosting the controller software. Java 9 and later are not yet supported. 

 

NOTE: Although Java is required on any machine that is actually hosting the UniFi Controller, it is not required to navigate to unifi.ui.com (the UniFi Cloud Access portal) to access .

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

We're sorry to hear that!