# Adopting UniFi Devices

This article will guide you through the process of adopting your Unifi devices such as Access Points, Switches and USG to your new Cloud Unifi hosted controller. Note: UXG-Pro and Flex Mini Unifi devices have different adoption instructions.

NOTE: Your inform URL is the name of your controller in this format: http://example.cloudunifi.com:8080/inform (replace "example" with your hosted controller id)

ATTENTION: Please ensure you are not running the Unifi controller software locally on your computer. AP’s will not show up in these tools if they have been auto-adopted by a local running Unifi controller.

# SSH

If you can SSH into the device, it's possible to do L3 adoption via CLI command:

NOTE: A factory default device has a username and password of ubnt (Otherwise you will need to know your device username and password)

Make sure the device is running fairly recent firmware.
Make sure the device is in the factory default state. If it's not, you run the following command or complete a physical factory reset of the device:

sudo syswrapper.sh restore-default

SSH into the device and type the following and hit enter, substituting "example.cloudunifi.com" with the domain name of your hosted UniFi Network Controller:

set-inform http://example.cloudunifi.com:8080/inform

ATTENTION: You may need to issue this command twice for the device to show up on the controller and be ready for adoption.

After issuing the set-inform, the UniFi device will show up for adoption in the Devices section of the controller. Once you click Adopt, the device will appear to go offline or have the status of "Adopting" then proceed to "Provisioning" and "Connected".

ATTENTION: If the device does not show up for adoption on the controller, you may have something blocking inform traffic port 8080 outbound on your network or computer. Check to make sure you are not blocking or modifying this traffic on your networks firewall, proxy or gateway device. You may also need to disable your Windows firewall when issuing the inform request.

# Mobile App

After installing the UniFi Mobile App (Available in iOS App Store & Android PlayStore), launch the app.

NOTE: Your mobile device must be connected to the same network as your devices, and must be able to access the controller directly (using HTTP). A public IP and/or port forwarding may be necessary. The inform port of the controller must be 8080.

Select your Controller from the list, or tap the "Add Controller" to log in and add your controller.

NOTE: The iOS app has changed recently. To add a new Cloud UniFi controller, tap on the user icon in the top left, then select "Discover Local Network Devices", then tap "Need Help?", then select "Manual Setup". Here you can add your hosted controller details to sign in and add your controller to the UniFi iOS app. Please use the hostname only in the "IP Address/URL" field.

For iOS: Once logged in to the Controller, tap More. There will be a Layer 3 Adoption option under Utilities. For Android: Once logged in to the Controller, tap More, then click on Remote Adoption from the menu.

Devices will be displayed on this screen. Tap on the device that is to be adopted and select Adopt.

After a few seconds (15-30 seconds, times will vary) the device will appear under the Devices section, which will be accessible by clicking on the Devices icon on the bottom menu bar.

# UniFi Toolkit

The UniFi Toolkit is a free tool that scans your local network for factory-default UniFi devices and adopts them to your Cloud UniFi controller. It is available for Windows, macOS, and Linux.

Download: UniFi Toolkit

NOTE: Your computer must be on the same Layer 2 network as your UniFi devices. The toolkit requires no installation — just download and run the single binary for your platform.

# Desktop App (macOS)

A desktop application with a graphical interface is available for macOS. Download the DMG installer from the releases page, open it, and drag the app to your Applications folder.

# Interactive Mode

Open a terminal and run the toolkit:

./unifi-toolkit

Select Adoption Mode when prompted. The toolkit will automatically detect your local subnet and scan for factory-default UniFi devices on the network.
Enter your controller inform URL when prompted: http://example.cloudunifi.com:8080/inform (replace "example" with your hosted controller id).
Select the devices you want to adopt. The toolkit will connect to each device via SSH using default credentials and set the inform URL automatically.
Open your hosted UniFi Network Controller and go to the Devices section. Your devices will appear with a status of "Pending Adoption" — click Adopt for each device.
The device status will change from "Pending" to "Adopting" to "Provisioning", then finally to "Connected".

# Non-Interactive Mode

For adopting devices without the interactive interface, run:

./unifi-toolkit --run -c example.cloudunifi.com -s 192.168.1.0/24

Replace example.cloudunifi.com with your controller hostname and 192.168.1.0/24 with your local subnet.

NOTE: If you have changed the default device credentials from "ubnt", you can specify custom credentials with the -u and -p flags.

unifi