UniFi - Controller FAQ


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 articles in the sections: Configure Controller and Using the UniFi Network Controller.

Frequently Asked Questions

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

Release Branch Definition Current Release
EOL Product Support Release that is maintained for products that do not support newer firmware versions. 5.6.42 
Stable General availability (GA) release. 6.0.23
Release Candidate Release we think can go to Stable unchanged. Formerly called Stable Candidate.


Testing Feature-frozen, going to Release Candidate and then Stable. -
Unstable Branch where new features are being added. 6.0.4


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.

Why do I see Release Candidate and Stable releases in the Official release section on the community?

Release Candidate versions are essentially what is being targeted for Stable. The developers find value in getting these out to a broader audience. If there are no known bugs and nothing discovered in testing, then this release may be promoted to Stable after one week from the initial time it was released to official. Sometimes this process is accelerated and other times it's delayed depending on findings.


The Beta section of Releases will hold versions in Unstable, Testing, and Release Candidate stages. The Official section, will only share Release Candidate and Stable stages.

Why can't I find the latest release in the repo for Debian/Ubuntu?

A release is initially only available via the Downloads page or release post on the Releases section of the Community. As a general rule, one week after a release goes Stable it will be made available on the repos. There will be some exceptions where this period will be shorter or longer. There are also cases where a release goes Stable but a bug is spotted and it is not pushed out to the repo. Instead the team will work on a follow-up release which fixes the bug, promoting that release to stable instead. The follow-up release may follow an accelerated release plan or it may go through the regular one-week intervals.

What are the system requirements for the UniFi Network Controller?

These are the minimum system requirements for the UniFi Network Controller to run optimally. It is important to read the Release Notes of each UniFi Network Controller software version release. It will include any special considerations to keep in mind before installing. A link to the Release Notes will he available in the Downloads page along with the corresponding software version, or find past Release Notes in the Software Releases section of our community.

Operating System:

  • Linux: Ubuntu Desktop / Server 16.04; Debian 9 "Stretch"
  • Windows: Windows 10; Windows Server 2016
  • macOS: Mavericks 10.9, 10.10 Yosemite, 10.11 El Capitan, 10.12 Sierra, 10.13 High Sierra, 10.14 Mojave, 10.15 Catalina.

CPU: x86-64 Processor (Intel / AMD x64 Processors)*


Network: 100Mbps Wired Ethernet*

HDD: Minimum 10GB free (20GB or more preferred)*

Java: Java Runtime Environment (JRE) 8. Java 8 does not come bundled with the UniFi Network Controller software after version 5.11.47, so this must be installed separately. The UniFi Network Controller does not support Java 9.

Web Browser: Google Chrome

MongoDB: version 3.2 or later (Mongo is offered bundled: default bundled is 2.4.14 (for macOS and Windows only)).

*NOTE: Actual Storage, CPU, RAM, and Network speed requirements will depend on many factors including the number of UniFi devices managed by the controller, number of clients, features enabled, and data retention settings. For database repair, you require free space equal to the current database size, plus 2GB.

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

It's recommended to always run 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 older models: 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.

There will be situations where a beta version is suggested because it fixes a specific issue. Bear in mind though, that beta versions of software, firmware or hardware are not in support's scope (chat, email or ticketing). For issues or feedback on beta products, you can post on the Community and you'll receive assistance not only from Ubiquiti employees, but from other users as well.

Does the UniFi Network 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 the access points or other devices. All configurations, as well as internet connectivity, will continue working as usual. However, anything running on the Controller directly instead of a device will be lost; 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 that 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 with the button once it is enabled. To configure these two settings:

Classic Controller Mode:

  1. Go to Settings > User Interface and scroll down to the Data subsection.
  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.


New Settings (Beta) Mode:

  1. Go to Settings > Preferences > Advanced to the Data section.
  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 Network Controller?

Yes! The UniFi Network 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 contact UI-AlexCaldas on the Community 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:


On the Classic Controller Mode:

  1. Go to Settings > User Interface and the Localization subsection.
  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.


On the New Controller Settings (Beta):

  1. Go to Settings > Preferences > Formatting.
  2. Select the language you prefer from the Language drop-down menu.
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 Network 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. 


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. We do not support older version upgrade, if you happen to have a v2 controller, you will have to reset it or uninstall and set it up again with a current version.

What Java / JRE version should I be using?

Current Stable Release: An updated/current version of 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 the UniFi Cloud Access Portal from where you can launch your Controller locally or remotely (if enabled). 

How can I trigger a provision?

Whenever a configuration is modified within the UniFi Network Controller, it will be automatically detected and a provision will be triggered. However, if you are changing configurations by modifying the config.properties file for example or any other configuration file outside of the controller interface, 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
Was this article helpful?
86 out of 301 found this helpful
Can't find what you're looking for?
Visit our worldwide community of Ubiquiti experts for more answers
Visit the Ubiquiti Community