Overview

This article provides info to assist with adding new devices to your UISP Application for remote management, as well as troubleshooting steps whenever device discovery or adoption fails.

Steps: Add via Mobile App

Due to ease & simplicity, adding devices using the UISP Mobile App is Ubiquiti's recommended method. The UISP Mobile App is freely available on the Apple App Store & Google Play Store.

1. Connect power to your device.
   
   1. For ISP wireless devices, this means connect Ethernet cables to the respective POE port of your ISP wireless device for power. After ~60 seconds, your ISP wireless device will begin broadcasting a local network, to which you'll connect using the UISP Mobile App.
   2. For UISP Routing/Switching devices (ex. UISP Console, UISP Router), this means connecting the included power supply. After ~60 seconds, your UISP device will begin broadcasting a bluetooth network, to which you'll connect using the UISP Mobile App.
      NOTE: Other wired devices (ex. EdgeMAX, UFiber, SolarPoint) may not feature a bluetooth radio, but you can still set up using other methods mentioned in this article, including via Device Web UI or via UISP Application.
2. Download the UISP Mobile App to your mobile device. UISP Mobile app is available for both Android (Google Play) & iOS (App Store) devices.
3. Enable the Bluetooth radio for your mobile device.
4. Open the UISP Mobile App, and proceed with the steps in the UISP Mobile App.

With UISP Mobile app, quickly connect to devices, configure easily in seconds, then monitor centrally on the UISP dashboard.

Steps: Add via Device Web UI (Connect to Device Directly via LAN)

This method requires connecting your device to your local network — if the UISP Application is running on a remote network (ex. Ubiquiti's Cloud platform), then Internet access is essential for device adoption.

1. Connect power to your device.
   1. For ISP wireless devices (ex. airMAX, Wave, airFiber), this means connecting your radio to the port labelled PoE on the power injector.  The Ethernet port is auto-sensing. You are not required to use a crossover cable.
   2. For routing/switching devices (ex. EdgeMAX, UFiber), use the included power supply to provide power to your device.
2. Connect your device to your Internet-connected network to allow for discovery & adoption to your UISP Application.
3. Install WiFiman or check your DHCP servers lease table to find the device MAC address and IP address assigned.
   Note: As of airOS M v6.3.2, airMAX M radios when reset to factory default will first try to obtain an IP address via DHCP.  If an IP address isn't obtained via DHCP, the radio will fallback to 192.168.1.20
4. Launch your web browser and enter IP address obtained from Step#3 as URL to gain access to the device's management console.
5. Enter ubnt / ubnt for the default username / password.
6. Ensure that your device is updated to the latest firmware version.
7. From within the device's web UI, click on the UISP button to connect your device to the UISP Application via the device's web UI.
   NOTE: The unique UISP Key is required in order to adopt your device to your UISP Application. This key can be viewed/copied directly from the Settings >> Devices section of your UISP Application.

Steps: Add via UISP Application Web UI (Discovery via Web Browser)

The UISP Discovery feature is a system designed to find devices in your network and easily adapt them to the UISP application. There are two methods used to discover devices:

• Scan from the UISP Search for devices in the network(s) connected to the UISP console.
• Scan from Devices Search for devices from other currently connected/adopted devices.

The second option allows UISP to discover devices inside private network ranges or behind NAT. It is even possible to automatically upgrade the firmware of a device if it does not meet the minimum requirements. The Scan from Devices option is especially useful for UISP Cloud users as it allows you to automatically discover and connect to local LAN devices from the Cloud.

Listed below are steps to discover/adopt your device via the UISP Application web UI:

1. While in its factory-default state, connect power to your device.
   1. For ISP wireless devices (ex. airMAX, Wave, airFiber), this means connecting your radio to the port labelled PoE on the power injector.  The Ethernet port is auto-sensing. You are not required to use a crossover cable.
   2. For routing/switching devices (ex. EdgeMAX, UFiber), use the included power supply to provide power to your device.
2. Connect your device to your Internet-connected network to allow for discovery & adoption to your UISP Application.
3. Launch your web browser and connect to your UISP Application (ex. myisp.uisp.com).
4. Enter your administrator username / password to connect to your UISP Application
5. Click on the Devices tab to view devices "Pending adoption", then click to Adopt/Manage within the UISP Application.
   

NOTE: By default (i.e., with "Automatic Configuration" toggled under Settings >> Devices), the UISP Application will include discovered devices under all connected network ranges accessible to your UISP Gateway device.

Troubleshooting Devices

Supported Devices

Back to Top

The UISP Application allows you to configure, upgrade, and monitor Ubiquiti's operator device platforms:

• UISP Wireless
• UISP Routing & Switching
• Wave
• airMAX
• airCube
• airFiber
• EdgeMAX
• UFiber
• SolarPoint

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 application (Cloud or self-hosted), or individually manage them. 

Ubiquiti Devices and services that can be managed through the UISP Mobile app.

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.

   Adding an airMAX Device

Back to Top

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

Afterwards, follow the checklist below. Each option can be expanded for additional information.

If you still cannot discover the device then try the following steps:

• Close the app completely (force if needed) and re-open it. 
• Restart your phone and re-open the app.
• Completely uninstall the app and re-install it.
• Reset the airMAX device to factory defaults using the steps provided in the Quick-Start Guide (QSG).
• Create a new post in the airMAX section on the Ubiquiti Community forum to get advice from our Community experts.

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

Verifying the nearby SSIDs with WiFiman.	Discovery after connecting to the SSID.	Logging in to the device.

   Adding an airCube

Back to Top

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

Afterward, follow the checklist below. Each option can be expanded for additional information.

If you still cannot discover the device then try the following steps:

• Close the app completely (force if needed) and re-open it. 
• Restart your phone and re-open the app.
• Completely uninstall the app and re-install it.
• Reset the airCube to factory defaults using the steps provided in the Quick-Start Guide (QSG).
• Create a new post in the airCube section on the Ubiquiti Community forum to get advice from our Community experts.

Below is an example of discovering an ACB-AC using UISP Mobile and the WiFiman Mobile App:

Verifying the nearby SSIDs with WiFiman.	Discovery after connecting to the SSID.	Logging in to the device.

   Adding an EdgeMAX Device

Back to Top

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

Afterward, follow the checklist below. Each option can be expanded for additional information.

If you still cannot discover the device then try the following steps:

• Close the app completely (force if needed) and re-open it. 
• Restart your phone and re-open the app.
• Completely uninstall the app and re-install it.
• Reset the EdgeMAX device to factory defaults using the steps provided in the Quick-Start Guide (QSG).
• Create a new post in the EdgeMAX section on the Ubiquiti Community forum to get advice from our Community experts.

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

Running a WiFiman subnet scan.	Discovery after connecting to the local Wi-Fi.	Logging in to the device.

Related Articles

Back to Top

UISP - Site & Device Management