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
- App Overview
- Standalone Mode vs Controller Mode
- Standalone Mode
- Controller Mode
- Related Articles
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: Controllers, Devices, and Account.
The Controllers screen displays an overview of the controllers you can manage. From here, you can add a new controller, you can customize this screen's behavior and you can launch the controller management interface.
You can change behavior of this screen by tapping on the slider button in the top right, which presents a screen with options you can modify such as: requiring a password to launch a controller, screen tapping behavior, as well as display options (where to show the launch button), and how to display the different types of controller. The explanation of each is found in the app screen as shown in the screenshot below.
Back on the Controllers screen, tap on a controller from the list to launch its management interface. See the Controller Interface section for a quick overview of this interface.
The Devices screen displays a list of unmanaged UniFi devices discovered on the local network. The main purpose of this screen is the overview and management of your standalone devices (see Standalone Mode vs Controller Mode section).
NOTE: Ensure that your mobile device is connected to the appropriate network for proper device discovery. Devices already managed by an active UniFi Controller will not be discovered.
To connect to an AP’s default Wi-Fi network: If you don’t have a Wi-Fi network yet, you can start by scanning an unconfigured AP’s QR code and connecting to its default network. Tap on “Connect to AP” and follow the instructions in the wizard. The device will then show up in the list.
Device management: Tap the device you want to manage. A device detail screen appears with a basic overview. From here, you can configure the device by tapping on the Configure button.
This screen allows you to manage your Ubiquiti account(s) and change various settings.
Login: Tap to log into your Ubiquiti SSO account. (If you already have an account, a screen will be presented with the possibility to manage your accounts.) 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.
Within this Account page you will also find the section for Settings as well as the section for Info, Support & Feedback. A quick description of each item in these sections is found below.
Standalone Devices: Here you can update the username, password and country used for configuring your standalone devices. Please ensure that the selected country corresponds with the country in which your devices are located. These settings will be applied the next time you change your device’s configuration.
NOTE: We strongly recommend changing the Username and Password; otherwise, anyone on your network may be able to access your devices.
Color Scheme: Here you can change the look and feel of the app.
Inactivity Lock: Disabled by default. If you enable this option, the app will be locked after a specified time and you will have to authenticate before using it with Face ID, Touch ID, or a passcode.
NOTE: If inactivity lock is enabled, the UniFi mobile app content will always be hidden in the system app switcher.
Language & Permissions: Tap to configure the language and access permissions for the UniFi mobile app.
Info, Support, & Feedback
Ubiquiti Blog: Tap to visit the Ubiquiti website for blog articles.
Help: Tap to visit the Ubiquiti 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 Ubiquiti website for information about the app’s licenses.
Standalone Mode vs Controller Mode
Before setting up your devices, you should decide whether you want to use our controller software or configure your AP's without it.
The Controller mode 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).
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.
The following section shows how to configure a brand new, out of the box UniFi AP nanoHD using Standalone Mode.
1. Follow the access point's Quick Start Guide to connect it 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. Tap on the device you want to adopt.
NOTE: If a WiFi network is not set up yet, tap the "Connect to AP" button and follow the wizard that appears before continuing with the following steps.
2. This will take you to the Overview screen. Now to configure your device, select Configure in the upper right hand corner.
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.
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.
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.
6. Click Connected Clients to view the list of connected clients. Click on the client you want to see.
7. In this screen you can view the client information, including how long it has been connected to your network, and the traffic it is responsible for. Scroll down and click Block to make this client unable to connect to this access point.
The following section shows how to add and access your controllers. 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 UniFi User Guide.
But the More screen also includes the following three utilities, specific to the Mobile App:
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.
How to Add and Set Up a Controller
Setting Up New Controllers
UniFi devices that can run a controller (like a UniFi Cloud Key or a UniFi Application Server) require initial setup before being ready for use. Those devices will show up after tapping on the “+” button in the Controllers screen. Find the device you want to set up and tap on “Set up this controller”. You will then be presented with a wizard. Simply follow the instructions to set up your device.
Adding Already Setup Controllers
Cloud-enabled controllers: This is the preferred way of adding a controller. You will be able to easily access your controllers from anywhere in the world without the need of a public IP, or having to open ports etc.
1. Log in to your Ubiquiti account in the mobile app. Go to Account, then tap on Log In and log in using your Ubiquiti SSO account.
2. After logging in, your cloud controllers will be displayed in Controllers.
NOTE: If you can’t see your cloud controllers, make sure your controller has cloud access enabled. This can be done after logging into the controller interface and going to Settings > Cloud Access. An Ubiquiti SSO account is required; if you don’t have one yet, you can create it at account.ubnt.com. You can also verify that your controller is linked with your account by visiting unifi.ubnt.com.
Direct Access: You can set up a custom connection to the controller, which doesn’t use our cloud service. This may come in handy if your controller doesn’t have internet access, or if our cloud service is temporarily unavailable (e.g. when under maintenance).
To add a direct access connection:
1. In Controllers, tap on the “+” button, then tap on “Log in to existing controller”.
2. Fill in the IP address, port, and credentials, and tap on “Log in”. After a successful login, the connection will be saved and be later accessible from the Controllers screen.
NOTE: In general, direct access connection to a controller can be used only if you are on-site (meaning you are on the same network as the controller).
After launching a controller, you can explore its interface for management. You can start by adopting your devices in the Devices screen. If you decide to go back to the list of controllers, tap on the “Controllers” button in the Dashboard.
Controller: Configuring a Device
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.
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.
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.
Controller: Configuring a Client
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.
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.
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.