Unifi — getting started

User Notes & Tips

These notes have been added thanks to user collaboration. 

  • This Community post shares some scripts for UniFi Controller software installation on Ubuntu 18.04 and 16.04 and Debian 8/9.
  • If you are installing in a VM or a headless server, you may encounter entropy issues. This could be anything from slow service start/restart to complete service failure. The fix is to install . This is an external link for a tutorial on the subject.
  • Since UniFi Controller version 5.6.x the UniFi service does not run as root. This means that you cannot bind to privileged ports (<1024). The controller will fail to start if you try to use these ports. 
  • The following affects APT versions 1.5 onward (Ubuntu 17.10 and Debian Sid or newer). A recent version of the apt-secure man page stated: «Since version 1.5 changes in the information contained in the Release file about the repository need to be confirmed before APT continues to apply updates from this repository», meaning that when performing an update from a major version to the next (for example 5.5.x to 5.6.x) the will result in an error.
    • To fix this run the command the following way: 
    • If you receive an error stating the command is not understood in combination with the other options, users have reported that issuing the following two commands has fixed it: issue  and hit enter, followed by  and enter.
  • The UniFi Controller, when installed on Debian and Ubuntu, will not have a GUI since it’s being run as a Service. Please use the service command for starting, stopping and restarting the UniFi Controller.
  • If you see the following error on your DNS server, a user reports solving this by forcing the system to use as DNS server, not his ISP.
  • At the moment Ubiquiti does not support arm64, hence it is not available via the repo. A download and manual installation will be necessary for this.
  • In the Add the GPG Keys, method B: Source: External Link. For users behind restrictive firewalls the following command will allow them to import the GPG key:

  • Because of the Java 8 dependency, when using UniFi controller 5.7.X some additional steps might be needed. See  for details.
  • The command  is  in Ubuntu older than 16.04.

Frequently Asked Questions

How do I install the controller on my UniFi Dream Machine or UniFi Cloud Key?

There’s no need for a separate setup since all UDM, UDM-Pro and UCK models come with the UniFi Network Controller pre-installed.

You will go through the process of configuring the controller on these devices during the initial device setup and configuration.

I’m getting a Java-related error during setup, what do I do?

The UniFi Network Controller requires Java, so you’ll need to install Java 8 for your specific platform before re-running the installer.

The install is not finishing successfully, what could it be?

Make sure that all  are met and that all ports used by UniFi are open. If that is all in order, check that the ethernet cables are in good working condition, changing them with others if need be.

How do I access the controller configuration page if I don’t know my IP?

First, try accessing the controller via one of the common addresses: localhost:8443 or

If this doesn’t work, you will need to find out the address of your gateway by using commands like ipconfig/ifconfig or device discovery tools like Ubiquiti’s WiFiman.

I’m getting a «Your connection is not private» security warning when accessing the controller in my browser, should I be concerned?

There’s nothing to worry about as it’s the intended behavior when connecting to your controller locally. Simply proceed to the next page by clicking Advanced > Proceed.

How do I upgrade after the initial setup?

When a new stable controller version becomes available, you will receive an upgrade prompt in your dashboard. Click it to upgrade to the latest version.

What are the UniFi Network Controller system requirements?

For self-hosted controller setups, we recommend the following minimum system requirements (make sure to read the Release Notes for more details about a particular controller version):

  • 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)
  • RAM: 2GB
  • Network: 100Mbps Wired Ethernet
  • HDD: Minimum 10GB free (20GB or more preferred)
  • Java: Java Runtime Environment (JRE) 8
  • Web Browser: Google Chrome
  • MongoDB: version 3.2 or later. Mongo is offered bundled: default is 2.4.14 (for macOS and Windows only).

Does the UniFi Network Controller have to run at all times?

Since UniFi devices retain their settings, internet connectivity will work even if the controller is offline.

However, the features running directly on the controller will be lost. This includes statistics, reporting, manually applied user groups and the Guest Portal.

For more information about using Guest Networks and running UniFi Access Points without the controller, see UniFi — Configuring the SELFRUN State and UniFi — Guest Network, Guest Portal and Hotspot System.

How do I reset my UniFi Network Controller admin password?

To use the ‘Forgot Password’ option, you will need to configure your SMTP credentials first.

Manage the UniFi Network

You can manage your UniFi network using the UniFi Network Controller, which is hosted on a UniFi device, local computer or a remote server.

The following UniFi devices come with the Network Controller pre-installed:

  • UniFi Dream Machines, such as UDM and UDM-Pro. The UDM-Pro can also host the UniFi Protect controller simultaneously.
  • UniFi Cloud Keys, such as UC-CK, UCK-G2 and UCK-G2-Plus. The UCK-G2-Plus can also host the UniFi Protect controller simultaneously.

Alternatively, you can install the UniFi Network Controller on a computer or server running macOS, Windows or Linux operating systems.

After you’ve set up the controller, you can also manage it on the go using the UniFi Network mobile app.

If you only have one or a few access points and don’t need advanced configuration, you can use the UniFi Network mobile app to set up a UniFi Access Point in Standalone Mode without needing the UniFi Network Controller.

Upgrade Device Firmware and Controller Software

To make sure your UniFi network is stable and you have access to the latest UniFi features, we recommend keeping your devices and the controller up to date.

Updating device firmware will be one of the first steps you’ll need to go through after setting up a new UniFi device.

Update via the UniFi Network Controller

You can update your UniFi device firmware via the Devices page in the controller by hovering over a device and clicking Update or the upgrade icon. 

To update the UniFi Network Controller software, simply follow the update prompt you will see in the upper right corner of your screen when a software update is available.

You can also update the controller manually via Settings > Updates.

Update via the UniFi Network Mobile App

Alternatively, you can use the UniFi Network mobile app to upgrade your devices and the controller.

Device upgrades can be done by navigating to Devices > Click on Device > Upgrade (scroll down and find it in the Actions list).

To update the controller software using the mobile app, go to More > Settings > UniFi Settings > Controller Basics.

For more in-depth guides on firmware and software upgrades, see the following articles:

  • UniFi — Upgrade the Firmware of a UniFi Device
  • UniFi — How to Set Up a UniFi Network Controller

Database Connection Tuning

When running a large UniFi installation, it may be desired to run an external Mongo cluster to be able to scale the database independently from the UniFi Network Controller application. Discussion on that can be found on our Community Beta forum (need access?). If high CPU usage is seen on the Mongo process, it can indicate the need of a bigger box or the need to separate the mongodb process as mentioned above. Once that is done, the following can be tuned to see if it results in better application performance: 


This results in 500 threads that can be waiting for a Mongo connection. So keep in mind that more threads can mean higher CPU usage because the CPU has to context-switch between threads. It may allow for higher DB throughput, but only if the Mongo process is able to consume more CPU to serve requests faster. 

Symptom: Heartbeat Missed or Slow to Provision

No matter the number, all devices will try to inform back to the Controller. By default, the controller can handle 200 simultaneous connections from devices, so devices with heartbeats missed shouldn’t be an issue unless a single Controller is managing thousands of devices. If it is only managing a few hundred devices the adjustment described in this section can be tried out, but it may not have the desired results. The number of simultaneous inform messages that can be processed can be set in the system.properties file by adding the following lines and adjusting the values to best suit your needs. It does not matter where these lines are added in the file.


The default value is 200 and the max_keep_alive_requests value should always be lower than than num_thread. Try adjusting up from there. An increase in device stability should be seen, and by pushing the configuration out to other devices, become even more stable. 


In order to update the UniFi Network Controller via APT, it is necessary to create source files or edit lines in an existing sources.list file with Linux text editors: vi or nano. That is the most common method for package updates and installs for these operating systems. The repo structure should be permanent, but if there are any changes they will be pointed out in the UniFi Network Controller software version release posts, found in the Community.

Follow the instructions below to stay with the current stable release, regardless of changes in versions. When there is a new stable release, there will be a post on the Community announcing it.


Основные характеристики
Описание UniFi AP AC LR — это точка доступа с повышенной мощностью радиочасти, которая составляет 22 dBm в диапазоне 5 ГГц и до 24 dBm в диапазоне 2.4 ГГц. Помимо радиочасти, также были усилены и встроенные антенны. Благодаря этому, зону уверенного охвата удалось расширить до 183 метров
Производитель UBIQUITI
Серия UniFi
Модель AP AC LR
Тип оборудования Точка доступанайти похожее Wi-Fi оборудование
Характеристики WiFi
Стандарты Wi-Fi WiFi AC (a/b/g/n/ac)
Максимальная скорость WiFi 867 Мбит/сек
Частота беспроводной связи 5 ГГц, 2.4 ГГц
Бесшовный роуминг Mesh, 802.11k, 802.11r
Поддержка Multiple SSID Есть, до 4 SSID
Режимы, беспроводные сети AP
Схемы обеспечения безопасности передачи данных WPA-Enterprise; WPA-PSK; WPA2; WPA; TKIP; AES; WEP-кодирование с 64- или 128-битным ключом
Централизованное управление точками доступа Возможно, централизованное управление множеством точек доступа через UniFi Controllerоборудование для кластеризации
Характеристики антенн
Радиус действия до 183 метров на открытой местности
Усиление антенны 3 dBi (5 ГГц), 3 dBi (2.4 ГГц)
Поддержка MIMO MIMO
Беспроводной сигнал и приемопередатчики
Выходная мощность, беспроводные сети 22 dBm
Сетевые характеристики
Соответствие стандартам 802.1Q (VLAN)
Поддержка WMM (Wi-Fi Multimedia) Поддерживается
VLAN Поддерживается, IEEE 802.1Q
Интерфейс, разъемы и выходы
Гигабитные порты 1 порт 10/100/1000 Мбит/сек PoE PD
Особенности корпуса
Корпус Пластик
Цвета, использованные в оформлении Белый
Кнопки Reset
Варианты крепления Крепление к стене
Рабочая температура -10 ~ 70 °C
PoE Поддерживается в соответствии с IEEE 802.3af (PoE), Passive PoE 24В 0.5А (Pairs 4, 5+; 7, 8 Return)
Питание PoE (Power over Ethernet)коммутаторы PoE и PoE-инжекторы
Блок питания Внешний, в комплектеблок питания
Потребление энергии 6.5 Вт
Комплект поставки и опции
Комплект поставки PoE-адаптер, Кабель питания, Крепеж к стене, Руководство пользователякомплект №1
Прочие характеристики
Прочее До 200 одновременных соединений
Размеры (ширина x высота x глубина) 176 x 43 x 176 мм
Вес 0.24 кг
Размеры упаковки (измерено в НИКСе) 22.5 x 21.4 x 10.27 см
Вес брутто (измерено в НИКСе) 0.921 кг
Служебные для сайта
EAN/UPC техподдержка 810354023507

Host the UniFi Network Controller yourself

Alternatively, you can download and host the UniFi Network Controller yourself on a local device or a server.

First, you’ll need to install the controller version for your platform. Make sure to meet system requirements before you begin.




1. Download UniFi Network Controller for Windows

You can find the latest controller version for Windows on our Downloads page.

2. Run the installer

Install the controller by running the installer and following the setup steps.

If you encounter a «This application requires Java» error, download and install Java 8 before re-running the installer.

3. Launch the UniFi Network Controller

Launch the UniFi application from the Start menu if it does not start automatically.

You will see a success message indicating the controller has started and proceed to start configuring it via your browser by clicking «Launch a Browser to Manage the Network».


1. Download UniFi Network Controller for macOS

You can find the latest controller version for macOS on our Downloads page.

2. Run the installer

Install the controller by opening the UniFi.pkg file and following the setup steps.

If you receive a message that says «UniFi.pkg can’t be opened because Apple cannot check it for malicious software» adjust your security settings.

3. Launch the UniFi Network Controller

Launch the UniFi application from the Applications folder if it does not start automatically.

You will see a success message indicating the controller has started and proceed to start configuring it via your browser by clicking «Launch a Browser to Manage the Network».

If you encounter a «Unable to load Java Runtime Environment», download and install Java 8 before re-running the installer.

1. Open a shell connection with the controller host

SSH or open a console to the controller host.

Switch to the /tmp/ directory with the command .

2. Copy the download link for the UniFi Network Controller for Debian/Ubuntu Linux

You can find the latest controller version for Debian/Ubuntu Linux on our Downloads page.

Click download and copy the URL.

3. Download the controller

Download the .deb software file with followed by the link you copied from the Downloads page.

4. Install the controller

After the download completes, use  to unpack the .deb file and install the controller.

If an error about missing dependencies is received, input the command  to solve.

5. Installation complete!

After the process completes the command prompt will return to entry. The controller software should be installed successfully at this point.

Some useful commands:

  • To start UniFi if the webpage prompt does not appear:
  • To stop the UniFi service:
  • To restart the UniFi service:
  • To see the status of UniFi service: 

UniFi Network Controller APT Steps

1. Install required packages before you begin with the following command:

sudo apt-get update && sudo apt-get install ca-certificates apt-transport-https

2. Use the following command to add a new source list:

echo 'deb https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list

NOTE:Trying to click and go to https://www.ui.com/downloads/unifi/debian on a browser will result in a 403 Forbidden page. This is because we do not allow direct listing/access to this link. The URL is only meant to be used when using the CLI commands as in the one shown above.

3. Add the GPG Keys. To add the GPG Keys use one of the two methods described below (Method A is recommended). When using the commands below, it is assumed you have and installed, more information about can be found here, and here.

User Tip:For Ubuntu 18.04, run the following commands before installing UniFi in step 4.

wget -qO - https://www.mongodb.org/static/pgp/server-3.4.asc | sudo apt-key add -echo "deb https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.listsudo apt-get update

See an example of what scripts the Community is using to install the UniFi Network Controller on Ubuntu 16.04 and 18.04 in this Community post.

(Method A) Install the following trusted key into

sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ui.com/unifi/unifi-repo.gpg 

(Method B) Using apt-key.

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50 

4. Install and upgrade the UniFi Network Controller.

WARNING:On some Distributions, it’s possible an incompatible Java release can be installed during this step. We highly recommend running the following before proceeding with step 4.

sudo apt-mark hold openjdk-11-*

This should restrict Ubuntu from automatically installing Java 11. If you wish to undo this later, replace «hold» with «unhold».

sudo apt-get update && sudo apt-get install unifi -y

5.  This step may not be required, depending on the Linux distro you have. If your distro does not come with MongoDB, and it’s not available in their repo, then please see the MongoDB installation guide. You can find the latest installation guide for Ubuntu here, and Debian here. We recommend at least MongoDB 2.6.10. Some users have changed the backend to use MongoDB 3 successfully too.

6. The UniFi Network Controller should now be accessible at the computer’s configured local or public IP address, by typing that IP address in a browser’s navigation bar (Chrome is recommended). If it is not launching, use the following command:.

Other helpful commands are:

  • To stop the UniFi service:
  • To restart the UniFi service:
  • To see the status of UniFi service: 
  We strongly recommend staying with the stable release, but for those users who wish to do otherwise, click here to expand and see possible suite names, as well as code names in the table within.

«Testing» refers to the next generation release, it’s not released to the general public yet. «Stable» refers to the current stable release, that is the one supported by Ubiquiti and described in this article. «Old Stable» is the previous stable release, once it has been displaced by the new, current stable release.

Suite Name Code Name   Archived Code Names
oldstable unifi-5.10     The code names below have been archived and are no longer supported, these should only be used in very specific, rare scenarios.
stable unifi-5.11
testing *

unifi3, unifi4, unifi-5.3, unifi-5.4, unifi-5.5, unifi-5.6, unifi-5.7, unifi-5.8, unifi-5.9

*testing is empty at the moment 

How to Upgrade a UniFi Network Controller that is Running as a Windows Service

1. Open the UniFi Network Controller and make a backup.

2. Launch the Command Prompt as an Administrator. On Windows 10 this would entail right-clicking and selecting «Run as administrator». Please see Windows documentation to identify the appropriate method for your specific Windows version.

3. Change directory to the location of UniFi in the computer using the following command (exactly as it is here, no need to substitute anything):

cd "%UserProfile%\Ubiquiti UniFi\"

4. Once in the root of the UniFi folder, issue the following to uninstall the UniFi Network Controller service:

java -jar lib\ace.jar uninstallsvc

5. Once a new command prompt line is presented, that means uninstalling the service was successful. Update the UniFi Network Controller application’s version with any of the regular methods. Go to Settings > Maintenance in the Controller to upgrade to the latest public released version, or alternatively download the UniFi Network Controller installation package for Windows from the Downloads page or the Releases section of the Community.

6. Once the software update is successful, close the UniFi Network Controller application before going back to the Command Prompt.

7. In the Command Prompt issue the following to install the UniFi Network Controller service once again:

java -jar lib\ace.jar installsvc

8. Once you’re at a new command prompt line, after seeing the «Complete Installation…» message, issue the following:

java -jar lib\ace.jar startsvc

9. Close the Command Prompt window either by entering the command, or clicking the X.

10.To access the UniFi Network Controller now open a browser and go to https://localhost:8443. Alternatively, the desired interface IP, or FQDN that is mapped to that host (in place of “localhost”) may be used.

Frequently Asked Questions

My password isn’t working. What is the default username and password for UniFi devices?

The UniFi devices can have two possible factory-default credential sets:

  • root/ubnt
  • ubnt/ubnt

Note that you may require multiple sets of credentials when using UniFi:

  • device credentials
  • controller credentials
  • Cloud Access Portal credentials
  • UniFi Cloud Key and SSH credentials

For more information, see UniFi — Accounts and Passwords for Controller, Cloud Key, and Other Devices.

What generation is my UniFi device?

The table below shows the generation and wave of devices.

UniFi Access Points

UniFi Security Gateways (Firewall)

UniFi Controller Hardware (UCK, UDM and UAS)

Generation 1 Devices

Generation 2 Devices (AC Wave 1)

Generation 3 Devices (AC Wave 2)

  • UAP (Datasheet)(Quick Start Guide)
  • UAP-LR (Datasheet)(Quick Start Guide)
  • UAP-Pro (Datasheet)(Quick Start Guide)
  • UAP-IW (Datasheet)(Quick Start Guide)
  • UAP-Outdoor (Datasheet)(Quick Start Guide)
  • UAP-Outdoor5 (Datasheet)(Quick Start Guide)
  • UAP-Outdoor+ (Datasheet)(Quick Start Guide)
  • UAPv2 (Datasheet)(Quick Start Guide)
  • UAP-LRv2 (Datasheet)(Quick Start Guide)
  • UAP-AC* (Quick Start Guide)
  • UAP-AC v2* (Quick Start Guide)
  • UAP-AC-Outdoor* (Quick Start Guide)
  • UAP-AC-M
  • UAP-nanoHD
  • UAP-FlexHD
  • UAP-XG
  • UWB-XG
  • UAP-BeaconHD

* End of Life (EoL) and unsupported as of UniFi Network Controller version 5.7. Download here most current Controller version compatible (v5.6.40 LTS).

UniFi Switch (US models)

UniFi Switch (USW models)

  • UniFi Switch 16 XG
  • UniFi Switch 16-150W
  • UniFi Switch 24/48 PoE Models
  • UniFi Switch 24/48 non-PoE Models
  • UniFi Switch 8
  • UniFi Switch 8-60W
  • UniFi Switch 8-150W
  • UniFi Switch XG 6 PoE
  • UniFi Switch Industrial
  • UniFi Switch Flex
  • UniFi Switch 16 PoE
  • UniFi Switch 24 PoE
  • UniFi Switch 24 Pro PoE
  • UniFi Switch 48 Pro PoE

UniFi Routing & Firewall

  • UniFi Security Gateway
  • UniFi Security Gateway Pro 4

UniFi Controller Hardware

  • UniFi Dream Machine and UniFi Dream Machine Pro.
  • UniFi XG Server
  • UniFi Cloud Key Gen. 2 and Gen. 2 Plus
  • UniFi Cloud Key

Проверка миграции контроллера UniFi на новый сервер

Устройства UniFi, принятые на контроллере UniFi

Последний шаг в переносе контроллера UniFi на новый хост – проверка того, что все сетевые устройства были успешно приняты, и отправка данных на новый контроллер UniFi. Если все прошло хорошо, все ваши устройства на вашем новом контроллере должны сказать «Подключено», как показано выше.

Как я уже говорил, я несколько раз переносил контроллеры UniFi, и в процессе этого я многому научился. В этом руководстве по миграции Ubiquiti UniFi я попытался поделиться тем, что узнал, чтобы новичок мог следовать за ним. Если у вас возникли проблемы, просто напишите мне комментарий ниже, и я постараюсь вам помочь. В противном случае наслаждайтесь перемещением контроллера UniFi на новый сервер.

Источник записи: https://www.smarthomebeginner.com

How to Set Up the UniFi Network Controller as a Windows Service

1. Close any instances of the UniFi software on the computer. If the UniFi Network Controller was just installed, make sure to open the controller software manually at least once, or let it run at the end of the wizard. Once you see the message UniFi Controller (a.b.c) started, the controller may be closed.

2. Launch the Command Prompt as an Administrator. On Windows 10 this would entail right-clicking and selecting «Run as administrator». Please see Windows documentation to identify the appropriate method for your specific Windows version.

3. Change directory to the location of UniFi in the computer using the following command (exactly as it is here, no need to substitute anything):

cd "%UserProfile%\Ubiquiti UniFi\"

4. Once in the root of the UniFi folder, issue the following command to install the UniFi Network Controller service:

java -jar lib\ace.jar installsvc

5. Once you’re at a new command prompt line, after it says “Complete Installation…”, issue the following:

java -jar lib\ace.jar startsvc

6. Close the command prompt window either by entering the command, or clicking the X.

7. To access the UniFi Network Controller now open a browser and go to https://localhost:8443. Alternatively, the desired interface IP, or FQDN that is mapped to that host (in place of “localhost”) may be used.

NOTE:We recommend using Oracle Java JRE 8, which can be downloaded in Oracle’s website. For the UniFi Cloud Access portal (https://network.unifi.ui.com/) to work properly, only use x64 Java.


There are a few things to take into consideration when managing large UniFi installs with hundreds of devices and several sites connected to a single UniFi Network Controller. A Controller running under such a high load might encounter some issues if configured the same way as a Controller managing a much lighter load. There are some symptoms that can be recognized, diagnosed and worked on to improve the controller’s performance. 

The sections below show how to modify the UniFi Controller system settings by altering or adding values to the system.properties file. See the UniFi — Explaining the system.properties File article for more information on this file.

WARNING: Before proceeding with the configurations outlined below, make sure to create a backup of your machine and Controller configurations. A typo error could break the system. See the UniFi — How to Create and Restore a Backup article for more information.

Set Up a New UniFi Device

When setting up a new UniFi device, follow its Quick Start Guide to connect the hardware and launch the Setup Wizard.

If you are setting up multiple UniFi devices, connect them together and launch the Setup Wizard. It will allow you to adopt all of the connected devices at once.

The image above displays a typical UniFi network topology with a UniFi Cloud Key, UniFi Security Gateway and a UniFi Switch.

If you are using a UniFi Dream Machine, which acts as a Cloud Key, switch and a gateway, your topology might look like this:

If you’re not sure how to connect several devices together, remember:

  • Gatekeeper devices like routers and gateways connect to the internet via the WAN port (sometimes identified with a globe icon).
  • Other devices like access points, switches and clients connect to gatekeepers and to each other via the LAN ports.

Configure the UniFi Network Controller

The process of configuring the controller is the same for all platforms. You can access the configuration page at any time by typing https://<IP_of_Controller_host>:8443 into the navigation bar of a browser. 

If you see a «Your connection is your private» error, simply proceed to the next page via Advanced > Proceed.

Specify the name for your controller to make it easier to identify it when managing multiple networks.

2. Sign in with your Ubiquiti Account

You will need to sign in with your Ubiquiti Account you will use to manage your controller. If you don’t have an account yet, create it now.

3. Configure the basic network settings

Choose whether you want to enable automatic network optimization and auto backups (we recommend keeping both enabled).

If you have unadopted UniFi devices connected to your network, you will be able to configure them during this step.

Specify a name and password for your new wireless network.

Symptom: High CPU Usage

One of the most important metrics to monitor, is CPU usage on your UniFi Network Controller. High CPU usage is the first indication that there is an issue. Unfortunately, there is no silver bullet for this and just increasing the CPU is not necessarily the answer.

Allocating Additional Memory Before increasing the RAM allocation on your machine, first try increasing the `XMX` and `XMS` options. By default, the UniFi Network Controller has these set to 1GB.  The following lines set the xmx and xms to values to 2GB (2048MB):


The changes above would increase the memory the UniFi Network Controller is allowed to consume from 1 to 2GB. The reason why not having enough memory could cause high CPU usage, is because the Java Virtual Machine would be spending too many CPU cycles collecting garbage to stay within the 1 GB of memory allocated to the Controller. So before moving to a machine with more CPU resources, it is recommended to max out the available memory on that machine with the above settings. Then observe if CPU usage decreases. If 2GB is not sufficient, administrators may want to raise the limit to 4-8GB depending on the scale. In this case it would simply be increasing the value above in increments of 1024, i.e. 4 GB= 4096. 

NOTE: The jstat -gcutil Java command can be used to check whether the memory allocation is sufficient on your machine. See the Oracle documentation for more information.

Enabling High Performance Java Garbage Collector If increasing memory does not solve the problem, administrators may consider also adding this line to the system.properties file (note this only applies to Controllers other than Cloud Key):


This enables a new Java Garbage Collector that can help optimize performance. However, if after these changes high CPU usage does continue after memory increase, a larger machine with more CPU cores and more memory to handle the workload may be necessary.

Changing Mongo Version/Engine In persistent cases, administrators may consider updating MongoDB version to 3.2+ with WiredTiger as storage engine, as a means of better scaling the UniFi Network Controller. See the following links for instructions:

  • How to Upgrade to MongoDB 3.2
Оцените статью
Рейтинг автора
Материал подготовил
Андрей Измаилов
Наш эксперт
Написано статей
Добавить комментарий