UniFi - Getting Started

Welcome to UniFi Network!

Learn how to get started with UniFi, set up your devices and use the UniFi Network Controller to manage your new UniFi Network.

Set Up a New UniFi Device

Back to Top


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.

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

Back to Top

unifi-update.pngTo 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. upgrade.icon.png

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:

Adopt Additional UniFi Devices

Back to Top

Device adoption means adding a UniFi device to an existing UniFi Network Controller. You can adopt new UniFi devices during the initial controller setup or do it later.

For an in-depth guide for adopting UniFi devices, see UniFi - UniFi Device Adoption.

If you need to replace your current router with a USG, see UniFi - How to Adopt a USG into an Existing Network.

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.

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.

For a guide on using Gmail SMTP to reset the password, see UniFi - How To Use a Free Email Service as SMTP Server (Gmail.

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 the following articles:

What are the UniFi System requirements?

These are the minimum system requirements for the UniFi Network Controller to run optimally. It is important to read the Release Notes of each software version release. It will include any special considerations to keep in mind. 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 UniFi Updates Blog

When hosting on computer or server:

  • 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. 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 is 2.4.14 (for macOS and Windows only).

*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 generation is my UniFi device?

The table below shows the generation and wave of devices.


UniFi Access Points
UniFi Switch 8-150W
UniFi Switches
UniFi Security Gateway XG 8
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)

* 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)


Was this article helpful?
174 out of 560 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