UniFi - Getting Started with the UniFi Mobile App


 Overview


This is an introductory article about the UniFi Mobile app. It describes some of its features, its limitations and some configurations that can be done to your UniFi network while you're on the go. Join the discussion in the UniFi Wireless forum or make a feature requests in the UniFi Mobile Requests page.

NOTES & REQUIREMENTS:
This is a general overview of the UniFi app. It describes the iOS version of the app; however, the Android version is similar.

Table of Contents


  1. App Overview
  2. Choosing between Standalone Mode and Controller Mode
  3. Standalone Mode: How to adopt a new access point, configure it and block a client.
  4. Controller Mode
    1. Controller Mode: Using Direct Access
    2. Controller Mode: Using Cloud Access
    3. Controller Mode: Configuring a Device
    4. Controller Mode: Configuring a Client
  5. Initial Setup of Nearby Devices
  6. Related Articles

1. App Overview


Back to Top

The UniFi Mobile app is a mobile user interface (UI) for UniFi. You can keep an eye on your network or make quick configuration adjustments when you are on the go. This is a great solution for around the clock network support. There are versions for Android and iOS, available for free on the App Store and Google Play. The app is also connected to the Ubiquiti blog, so you can keep up to date with the newest developments.These are the main tabs:

  • Devices Nearby
  • Direct Access
  • Cloud Access
  • Account

Devices Nearby


The Devices Nearby screen displays a list of unmanaged UniFi devices discovered on the local network. (Ensure that your mobile device is connected to the appropriate network for proper device discovery.)

NOTE: Devices already managed by an active UniFi Controller will not be discovered.

To Manually Add: If your device is not detected, tap + to manually add it. The Setup Wizard screen will appear. Tap Connect to AP’s Wi‑Fi and follow the on-screen instructions.

List of Devices: Tap the device you want to add. The device screen appears.

You can change the Device Name and other settings. For more information about the available settings, refer to the User Guide, which is available at: www.ubnt.com/download/unifi

Direct Access


The Direct Access screen allows you to connect to a UniFi Controller on the local network.

To Manually Add: If your Controller is not detected, tap + to manually add it.

1. On the Log In screen, enter the following information:

  • (IP address): Enter the IP address of the UniFi Controller.
  • (port): Enter the appropriate port number, which is typically 8443.
NOTE: If you do not know the IP address, you can click Find to detect a UniFi Controller and then select it.
  • (username): Enter your username for the UniFi Controller.
  • (password): Enter your password for the UniFi Controller.
  • Remember username and password: Tap this option if you want the app to remember your username and password.

2. Tap Log In.

List of Controllers: Tap the Controller you want to access.

Try out a demo controller: Tap to access the demo at: demo.ubnt.com

Cloud Access


The Cloud Access screen allows you to access Controllers through your UniFi cloud account, which is also known as the Single Sign-On (SSO) account.

If no Controllers are found, tap Account > Log In, and log into your cloud account at: unifi.ubnt.com

Status: Displays the status of the UniFi cloud.

See More: Tap to visit: status.ubnt.com

Account


The Account screen allows you to access the following settings:

Login: Tap to log into your cloud account at: unifi.ubnt.com

On the Ubiquiti Account screen, enter the following information:

  • Username: Enter your username for your cloud account.
  • Password: Enter your password for your cloud account.
  • Remember Password: Enabled by default. This option allows the app to remember your password.
  • Use Touch ID: Enabled by default. This option allows the app to accept touch ID for login.
  • Create account: If you don’t have a cloud account, tap to visit: account.ubnt.com and sign up for an account.

Settings


Standalone Devices: Tap to log into standalone devices, which are not managed by a UniFi Controller. Read more about choosing between Standalone or Controller Mode in the following sections.

NOTE: We strongly recommend changing the Username and Password; otherwise, anyone on your network may be able to access your devices.

On the Standalone Devices screen, enter the following information:

  • Username: Enter a unique username.
  • Password: Enter a unique password.
  • Country: Ensure that the selected country corresponds with the country in which your devices are located.
  • Done: Tap to save your changes.

Inactivity Lock: Disabled by default. If you enable this option, you will have to authenticate before you are allowed to use the app. Authentication would also be required if the app is inactive for a duration of time that you can specify.

NOTE: The UniFi mobile app content will always be hidden in the system app switcher.

On the Inactivity Lock screen, configure the following:

  • Enable Inactivity Lock: Tap to enable this option.
  • Allowed Inactivity Time Period: Select the duration of time allowed for inactivity.
  • Done: Tap to save your changes.

Language & Permissions: Tap to configure the language and access permissions for the UniFi mobile app.

Info, Support, & Feedback


Ubiquiti Blog: Tap to visit the UBNT website for blog articles.

Help: Tap to visit the UBNT website for information about the UniFi mobile app.

Report a Problem: Tap to contact Support for a generic problem or request, or Developers for a problem or request related to the UniFi mobile app.

Live Chat Support: Tap for online chat support.

Rate the App: Tap to review the UniFi mobile app in the App Store® or Google Play.

Acknowledgements: Tap to visit the UBNT website for information about the app’s licenses.

 


2. Choosing between Standalone Mode and Controller Mode


Back to Top

Before setting up your devices, you should decide whether you want to use our controller software or configure your AP's without it.

Controller mode 


This is the preferred method for configuring your UniFi devices. You will be able to view the dashboard, devices, clients, statistics, insights, alerts, events and more; as well as view detailed information about devices and clients. Many configuration and settings options are available as well, and you can use it from almost anywhere in the world.

Advantages: all features are available with in-depth information and configuration; and it is accessible from anywhere (with Cloud Access enabled).

Disadvantages: the controller software must be installed and running (on a computer, server, or a UniFi Cloud Key).

Standalone mode 


This is an alternative method for configuring UniFi AP's. The app is designed for anyone who wants to control their AP's right away without taking the time to configure a controller. This is recommended for users who have only a few AP's, for instance at home, and wish to simplify the process.

Advantages: easy to set up; no software is required to be running.

Disadvantages: very few features are available; only UniFi AP's are supported; and you must be on-site to access devices.


3. Standalone Mode: How to adopt a new access point, configure it and block a client


Back to Top

The following section shows how to configure a brand new, out of the box UniFi AP AC LITE using Standalone Mode, as an example.

1. Connect the access point to the internet and power (you may use a UniFi Switch to get both at the same time). Open the UniFi Mobile app, and wait for the device to appear under Devices Nearby. Tap on the device you want to adopt.

NOTE: If a WiFi network is not set up yet, tap the + button and follow the wizard that appears before continuing with the following steps. 

 

Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_15.42.20.png

2. This will take you to the Overview screen. Now to configure your device, select Configure in the upper right hand corner.

Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_15.42.43.png

3. If the default username, password and country haven't been changed yet, this screen will appear for you to do just that. Make your changes and tap Done. 

Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_15.46.16.png

4. In the Configuration screen you can change several settings. Change the device's name for easy identification; turn on/off the device's LED; configure the Radios and WLANs; see what version the device is running on and upgrade from here directly. You can also reset the device to factory defaults by clicking on the red Reset button. Don't forget to hit Save on the upper, right hand corner after making any changes.

Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_15.47.06.png

5. Going back to the Device screen, from here you can perform specific actions on that device, such as: locating and restarting it, or checking the RF environment. This is also where you would access the clients. You can view the blocked clients or connected clients by clicking on the section you want.

Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_15.48.47.png

6. Click Connected Clients to view the list of connected clients. Click on the client you want to see.

Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_15.49.03.png

7. Here you can view the client information, including how long it has been connected to your network, and the traffic it is responsible for. Click Block to make this client unable to connect to this access point. 

Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_15.49.18.png


4. Controller Mode


Back to Top

The following section shows how to add and access your controllers. If you have a Cloud Key (which runs our controller software) that’s not yet set up, please go to section 5. After the UniFi mobile app accesses a UniFi Controller, its interface closely mirrors the web UI of the UniFi Controller with sections such as: Dashboard, Devices, Clients, Statistics. Within the More tab you'll find: Insights, Maps, Events, Alerts, Hotspot Manager, and Settings as would be seen in the UniFi Web Controller. For more information about the web UI settings, refer to the User Guide, which is available at: www.ubnt.com/download/unifi.

But the More screen also includes the following three utilities, specific to the Mobile App: 

Ping

1. Tap to ping another device on the network. The ping test uses ICMP packets to check the preliminary link quality and packet latency estimation between two network devices.

2. The Ping screen appears. 

3. Select Hostname. Enter the destination IP address or hostname and tap Done.

4. Tap Start to start the ping test. The test results will appear. Tap Stop to end the ping test.

Wi-Fi Throughput Test

You can test the wireless upload and download throughput using separate tests.

Start Download Throughput Test: Tap to begin the download test. Tap Stop Throughput Test to end the test.

Start Upload Throughput Test: Tap to begin the upload test. Tap Stop Throughput Test to end the test.

Upload: Tap the upload icon to upload the throughput test data. Follow the on-screen instructions.

Reset: Tap to reset the throughput test data (upper right corner)

Within the Wi-Fi Throughput Test section you will find the Connection Info, which displays the following:

  • Refresh: Tap to refresh the connection information.
  • AP Device: Displays the UniFi AP used for the test. Tap to access details about the AP.
  • SSID: Displays the SSID or wireless network name.
  • IP Address: Displays the IP address being used.
  • Channel: Displays the channel being used by the AP.
  • Signal: Displays the percentage of signal strength, as well as the signal strength in dBm.
  • TX Rate: Displays the transmit rate.
  • RX Rate: Displays the receive rate.

Layer 3 Adoption

1. Tap to adopt a device when the UniFi Controller is off-site.

2. The Layer 3 Adoption screen appears.

3. Tap the device you want to adopt, and then tap Adopt to confirm. 


4.1. Controller Mode: Using Direct Access


Back to Top

Direct access is the main method of accessing the controllers if you are on-site (meaning you are on the same network as the controller).

1. Open the UniFi mobile app and tap on Direct Access. Any controllers you access will be remembered and displayed here. You can edit them by tapping on the info button, or delete them by swiping left and choosing "Delete".

 Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_18.17.25.png

2. Tap on the + button to add a new controller. Fill in the credentials and tap on log in.

 Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_18.18.19.png

3. If the login succeeds, you will be redirected to Dashboard.

 IMG_0588.PNG

4. Now you can explore the controller mode. You can start by adopting your devices in the Devices screen. If you decide to go back to Direct Access, tap on the “Controllers” button in the Dashboard.


4.2 Controller Mode: Using Cloud Access


Back to Top

By using cloud access, you can easily access your controllers from anywhere in the world without the need to have a public IP, or having to open ports, etc.

1. First, you need to log in. Go to Account, then tap on “Log In” and log in using your Ubiquiti SSO account. If you don’t have one yet, you can create it at account.ubnt.com.

 IMG_0596.PNG

2. After logging in, your cloud controllers will be displayed in Cloud Access.

 IMG_0586.PNG

3. To use cloud access on a controller, connect to it using Direct Access first (see section 4.1). Then go to More > Settings > Cloud Access and enable it. 

 Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_18.40.48.png

4. You’re all set! Go to the Dashboard and tap on "Controllers" to go back to the list of your controllers. Your controller will now show up under Cloud Access and will be accessible from anywhere. If you want to connect to it, just tap it and after a few moments, you will be redirected to the controller’s interface.

 Simulator_Screen_Shot_-_iPhone_8_-_2017-11-14_at_18.45.16.png


4.3. Controller Mode: Configuring a Device


Back to Top

1. Once you are logged into the app and have selected your controller, tap on Devices on the bottom bar. This will bring you to a screen with a list of all your controller's devices. Tap a device to select it and go to its Overview screen, where you can see its most crucial information, as well as locating or restarting your device from this screen. You can also click on Configure on the upper right hand corner to make adjustments to this device.

IMG_0590.PNG

2. In the Configuration screen, you can change the Alias of the device for easier identification and configure close to the same things you would in the Web Controller. 

IMG_0591.PNG

3. Scroll further down to access the Manage Device section where you can perform custom upgrades, disable, provision or finally Forget a device if you no longer want to manage this device. All configurations set by the Web Controller or the Mobile app will be wiped out.


4.4. Controller Mode: Configuring a Client


Back to Top

1. Tap on Clients in the bottom toolbar. This will open a list of all clients. Select the one you wish to look into by tapping on its name.

IMG_0594.PNG

2. On the Client screen you can see its general information and from here you can see the results of the Deep Packet Inspection (DPI), see History, Statistics and you can Block or Reconnect them. Click on Configure in the upper right hand corner to make adjustments to this client.

IMG_0595.PNG

3. From the Client Configuration screen you can change the client's Alias for easier identification, add a Note for any notes you wish to keep about that client, change its User Group, or Network if you want to use a fixed IP Address.


5. Initial Setup of Nearby Devices


Back to Top

Some special devices (like a UniFi Cloud Key or a UniFi Application Server) may require initial setup before being ready for use.

Those devices will show up in the Devices Nearby screen. When you tap on them, you will be presented with a wizard. Simply follow the instructions to set up your device.

NOTE: If you can't see your device, tap on the + button and add it manually.

 

IMG_0598.PNG


Related Articles


Back to Top

UniFi - Throughput Heat Maps with the UniFi iOS App

UniFi User Guide