#
Adopting UniFi Flex Mini, USW-Ultra Switches, and Power Devices
Adopting a Flex Mini, USW-Ultra switch, or UniFi Power device is different from other UniFi devices as they do not support SSH. You can adopt them using the UniFi Toolkit or DHCP option 43.
#
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, including Flex Mini switches, USW-Ultra switches, and Power devices.
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 use L2 discovery to set the inform URL on these devices 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.
#
DHCP option 43
Once you powered the switch and connected to the LAN network, you will have to enable DHCP option 43 on your Router LAN network.
Follow this guide to enable DHCP option 43
Once the device has been adopted to the controller, go into Settings >> System >> Advanced, check the "Inform Host" Override option and input your hosted controller hostname (such as example.cloudunifi.com) and apply the changes. Your devices will replace the IP assigned to the inform URL with the hostname of your controller in the inform URL, but it may take 5-10 minutes.