×

UniFi Video will reach end-of-support on December 31st, 2020.

For more information, please refer to the official community notice.

UISP - Mobile App

Overview

Readers will learn how to add and manage EdgeMAX and airMAX devices using the UISP Mobile app.

NOTES & REQUIREMENTS:

Table of Contents

  1. Supported Devices
  2. Adding and Configuring an EdgeMAX Device
  3. Adding and Configuring an airMAX Device
  4. airMAX Firmware Upgrade
  5. airMAX Site Survey
  6. airMAX Alignment
  7. airMAX Speedtest
  8. Connecting to a UISP (Cloud) Controller
  9. Related Articles

Supported Devices

Back to Top

UISP allows you to configure, upgrade, and monitor several different Ubiquiti device platforms:

  • airMAX
  • airCube
  • airFiber
  • EdgeMAX
  • UFiber

The UISP Mobile app, available in the Apple App Store and on Google Play, is used to discover and access Ubiquiti devices on the local network. This is a very powerful tool that you can use to add devices to the UISP Controller (Cloud or self-hosted), or individually manage them. 

The exact steps on how to connect to the device and which credentials (username/password) to use will differ between the various Ubiquiti devices. For the most up to date information, we recommended downloading your device's Quick Start Guide (QSG) from our Download section.

The WiFiman Mobile App, and WiFiman Desktop can also be used to discover Ubiquiti devices.

edgerouter.png   Adding and Configuring an EdgeMAX Device

Back to Top

topology.png

Adding an EdgeMAX device (EdgeRouter-4) to an existing network in order to manage it with the UISP Mobile app.

Before starting, please check the appropriate Quick Start Guide (QSG) of the device from the EdgeMAX Download section for the installation steps.

On EdgeRouter devices, starting from the v1.10.6 and v2.0.0 firmware releases, the DHCP client feature is enabled by default on the eth1 interface. If you are connecting the device to an existing network, then it is recommended to connect the EdgeRouter using the eth1 interface for initial configuration. EdgeSwitch devices (ES, ES-X, and ES-XP) will try to obtain a DHCP assigned address by default on any interface.

NOTE: Use the WiFiman Mobile App to run a subnet scan to find all devices on the local network. 

Below is an example of discovering and logging into an ER-4 using UISP Mobile and the WiFiman Mobile App:

wifiman-edgemax.png discover-edgemax.png logging-in-edgemax.gif
Running a WiFiman subnet scan. Discovery after connecting to the local Wi-Fi. Logging in to the device.

 

NOTE: See the Adding a New Device on the Mobile App article if you are experiencing trouble discovering your device. 

After logging in, the UISP Mobile app can be used to configure various options on the EdgeRouter, such as:

  • Ethernet Interfaces
  • VLAN and PPPoE Interfaces
  • System Settings
  • DHCP Server
  • Backup
  • Firmware upgrade
  • Reboot
  • Factory Reset

You can also add the device to a self-hosted or UISP Cloud controller if you have previously connected to a UISP controller using the app Controllers settings. See the Connecting to a UISP (Cloud) Controller section below for more information on how to connect the UISP Mobile app to a UISP controller.

interfaces-edgemax.png options-edgemax.png vlan-pppoe-edgemax.png
Interfaces settings. Options menu in the top-left corner. Add VLAN or PPPoE interface.

To change the UISP controller settings on the EdgeRouter, either tap on the UISP Status section or open the options menu and navigate to the System > UISP Connection settings.

The UISP app pushes the UISP connection key to the device. This key will include the hostname/IP address of the UISP server that is defined in the Settings > UISP > Server Settings > UISP Hostname/IP section on the UISP controller.

system-edgemax.png unms-edgemax.png status-edgemax.gif
System settings. UISP Connection settings. UISP connection status.

nanobeam.png   Adding and Configuring an airMAX Device

Back to Top

With UISP Mobile users can perform the same system configuration and monitoring as they would on the Web UI (with the one exception of advanced mode in network configuration). There are some features that are included in UISP Mobile, which are not found in the Web UI. For example:

  • Credentials memory UISP Mobile remembers connection credentials, such as IP addresses, usernames, and passwords.
  • Automatic IP detection If the user changes the device's IP address, UISP Mobile can automatically detect the new IP address and re-connect to it without user intervention.
  • Continuous site survey UISP Mobile runs a site survey in a loop and shows the current and best signal for every discovered network. A technician could move the antenna around, adjusting it, for a few minutes and then very easily check what was discovered and what strength of the signal was achieved.

With UISP Mobile a user can do any number of things. Some basic scenarios of activities that can be achieved through the app include:

  • Install a new CPE or AP with the U-Installer. The new U-Installer is a portable AP with an internal battery and a single ethernet port with 24V PoE, all this enabling a user to connect any airMAX device to the U-Installer port and start an installation without the need for cabling.
  • Realign an existing CPE using UISP Mobile's antenna alignment feature.
  • Check connected stations.
  • Measure connection speeds.
  • Discover existing devices on a connected network.

Before starting, please check the appropriate Quick Start Guide (QSG) of the device from the airMAX Download section for the installation steps.

Devices such as the NBE-5AC-Gen2 broadcast a management SSID for 15 minutes after power-on. Connect your phone to this SSID (or another wireless network that the airMAX device is connected to) in order to discover and manage the device.

NOTE: Use the WiFiman Mobile App to discover nearby SSIDs and their signal levels.

Below is an example of discovering an airMAX device such as the NBE-5AC-Gen2 using UISP Mobile and the WiFiman Mobile App:

wifiman-airmax.png discover-airmax.png logging-in-airmax.gif
Verifying the nearby SSIDs with WiFiman. Discovery after connecting to the SSID. Logging in to the device.
NOTE: See the Adding a New Device on the Mobile App article if you are experiencing trouble discovering your device. 

After logging in, the UISP Mobile app can be used to configure various options on the airMAX device, such as:

  • Wireless and Wired Network Configuration
  • Management Network Settings
  • System Settings
  • Services
  • Antenna Alignment
  • Speedtest
  • Reboot
  • Factory Reset
  • Firmware Upgrade
  • Ping and Traceroute
  • Device Discovery
  • Site Survey
  • Backup

You can also add the device to a self-hosted or UISP Cloud controller if you have previously connected to a UISP controller using the app Controllers settings. See the Connecting to a UISP (Cloud) Controller section below for more information on how to connect the UISP Mobile app to a UISP controller.

To change the UISP controller settings on the airMAX device, tap on the UISP  Status bar at the top of the screen.

The UISP app pushes the UISP connection key to the device. This key will include the hostname/IP address of the UISP server that is defined in the Settings > UISP > Server Settings > UISP Hostname/IP section on the UISP controller.

home-airmax.png options-airmax.png network-airmax.png
Home screen. Configuration menu in the top-right corner. Management Network options.

 Some of the more common airMAX installation steps are explained in greater detail below.

nanobeam.png   airMAX Firmware Upgrade

Back to Top

Follow the steps below to upgrade the firmware of an airMAX device using the UISP Mobile app.

NOTE: It is possible to use the app to download and store firmware releases.

1. After logging into the device, open the options menu in the top-right corner and select Firmware Upgrade.

2. Verify the current firmware version.

3. If you have previously downloaded the firmware through the UISP app, it will show up here.

4. If the firmware has not been downloaded yet, log out of the device and open the Tools tab. 

5. Select Firmware and look for the firmware release that you want to install.

6. Verify if the firmware release is applicable to your device and download it.

7. Afterwards, log back into the device and navigate to the Firmware Upgrade section to update the firmware.

options-airmax.png firmware1.png firmware2.png
firmware3.png firmware4.png firmware5.png
firmware6.png firmware7.png firmware8.png

nanobeam.png   airMAX Site Survey

Back to Top

Follow the steps below to run a Site Survey on an airMAX device using the UISP Mobile app.

1. After logging into the device, open the options menu in the top-right corner and select Site Survey.

2. The app will automatically start scanning for nearby wireless networks.

3. Choose the SSID that you want to connect to from the Wireless configuration section.

options-airmax.png survey-airmax.png wireless-airmax.png
Home screen. Running the site survey. Wireless network configuration.

nanobeam.png   airMAX Alignment

Back to Top

Follow the steps below to (re)align an airMAX device using the UISP Mobile app.

1. After logging into the device, open the options menu in the top-right corner and select Antenna Alignment.

2. The app will automatically start disabling the signal strength.

3. You can swipe to the secondary pane to view the local and remote signal process.

NOTE: There is an audio signal alignment option top-right corner. When enabled, the app will start generating a tone with a frequency related to signal strength. You can use this feature to align the airMAX device without having to look at the screen.
options-airmax.png alignment1.png alignment2.png
Home screen. First pane. Secondary pane.

nanobeam.png   airMAX Speedtest

Back to Top

Follow the steps below to run a speedtest from an airMAX device using the UISP Mobile app.

1. After logging into the device, open the options menu in the top-right corner and select Speedtest.

2. You can manually add a speedtest target if the remote connection does not show up.

3. Add the IP address information and credentials of the remote device and start the test.

options-airmax.png speedtest1.png speedtest2.png
Home screen. Adding a speedtest target. Running the speedtest.

ubiquiti_logo.png  Connecting to a UISP (Cloud) Controller

Back to Top

The UISP Mobile app can also be used to connect to an existing self-hosted or UISP Cloud controller. Besides managing UISP itself, you can also easily adapt devices after adding the controller.

1. Navigate to the controller's tab and select I already have a Controller.

2. Add the IP address or hostname of the UISP (Cloud) controller.

3. Select Yes if presented with an untrusted SSL security warning.

4. Enter your credentials and sign in.

NOTE: The tabs (Devices, Controllers, Tools) at the bottom of the screen will be expanded and look different after adding the controller.
Screenshot_20201116-170503.jpg Screenshot_20201116-171444.jpg Screenshot_20201116-171505.jpg
Controllers tab. Adding the hostname or IP address. Entering the credentials.

Related Articles

Back to Top

UISP - Adding a New Device on the Mobile App

UniFi - Getting Started with the UniFi Mobile App

Was this article helpful?
26 out of 41 found this helpful