UniFi - Getting Started


Getting Started


Welcome to UniFi!

This article is not meant to be a comprehensive list of everything UniFi, but rather a collection of stepping stones to get started in the most informed way possible. After reading this guide, along with the linked related articles, users should take a look at the UniFi User Guide, which will provide descriptions for each section of the UniFi Controller.


Table of Contents


  1. Methods for Managing a UniFi Network
  2. Important Accounts and Passwords
  3. Device Setup
  4. Set up an Email Service (Forgot Password?)
  5. Related Articles

Methods for Managing a UniFi Network


Back to Top

Managing a UniFi network can be done on a variety of hosts. Below are the different platforms that are supported by Ubiquiti along with documentation to help you get started with it.

Platforms


Important Accounts and Passwords


There will be several different sets of credentials associated with UniFi and the Ubiquiti account. It is important to take note of these during installation. The following article goes in detail about all the accounts, usernames and passwords a UniFi user might encounter. It is a good idea to identify the different sets of credentials before creating them to avoid confusion later. See all about that here: UniFi - Accounts and Passwords for Controller, Cloud Key, and Other Devices


Device Setup


Back to Top

UniFi Devices Generation

For initial device setup, as well as checking setup requirements before you begin, use each product's Quick Start Guide (QSG). For the most complete list of specifications available for each product, check the device's Data Sheet (DS). All products that have individual product pages will have a link at the very bottom of the page to download both the QSG and the DS. In the table below, each product model contains its product page link. For products that don't have individual product pages, the Data Sheet and Quick Start Guide links are provided.

UniFi AP HD
UniFi Access Points
UniFi Switch 8-150W
UniFi Switches
UniFi Security Gateway XG 8
UniFi Security Gateways (Firewall)
UniFi Cloud Key &  UniFi Application Server

Adopting UniFi Devices

UniFi - How to: UniFi Device Adoption

UniFi - How to Adopt a USG into an Existing Network (to be used only when the USG will replace the working, current router in a network).

Upgrading UniFi Devices' Firmware and the UniFi Network Controller Software

It is important to note that there are two updates you will be performing on UniFi. The device firmware, which if you navigate to our Downloads page you will see it is a .tar file for the USGs and a .bin file for all other devices. And the UniFi Network Controller software which will be an .exe, .pkg, or .deb file depending on where you are hosting the controller (Windows, macOS and Debian/Linux or UniFi Cloud Key respectively). So for example, for the UniFi Cloud Key, you will have the need to update it's firmware (.bin file) and its software (.deb file).

UniFi - Changing the Firmware of a UniFi Devices: device firmware upgrade (or downgrade) via UI and SSH. Does not include Cloud Keys.

UniFi - How to Install & Upgrade the UniFi Controller Software: software upgrade on controllers hosted on macOS, Windows and Debian/Linux systems. Does not include Cloud Keys.

UniFi - How to Manage & Upgrade the Cloud Key: firmware and software upgrade via the webUI (controller and UCK management platform).

UniFi - How to Change the Cloud Key's Controller Version via SSH: software upgrade (or downgrade) for Cloud Key hosted controllers via SSH.


Set up an Email Service (Forgot Password?)


Back to Top

Setting up an email service such as SMTP through Gmail can assist in situations where cloud access is not enabled and an admin password has been forgotten. If cloud access has been enabled, the login can be attained through the UniFi Cloud Access Portal (https://unifi.ui.com). This step needs to be completed to use the Forgot Password? option.

UniFi - How To Use a Free Email Service as SMTP Server (Gmail)


Related Articles


Back to Top

UniFi - Controller FAQ

UniFi - Getting Started FAQ


We're sorry to hear that!