- Unifi set inform. Issue the command set-inform in step 1 above. The UniFi Network Learn how to adopt a UniFi device to the UniHosted free tier controller with our updated step-by-step guide. 80. Then fill in the fields as follows: Number: 43. I found the directions to ssh into the controller (10. This is a place to discuss all things Ubiquiti, especially UniFi. Getting the USW-Ultra adopted to HostiFi or any other cloud hosted UniFi Controller requires a few more steps. com Now Where is the UniFi Cloud Inform Link? The inform URL is supposed to be on the cloud console page. Everything seemed to be directing to . hope this works. The main controller is unifi. From the UniFi Controller interface, you can adopt the AP and configure it as per your network requirements. I did a set-inform for the troublesome AP. Can we set-inform them to port 8443 rather than 8080 so the communication is encrypted? Simple script for setting the "set-inform" for devices on the local subnet. It returns "/bin/ash: set-inform: not found. It doesn't MITM anything, it puts a "host-record=unifi, IP of set-inform URL " line in dnsmasq. Hello, Good day. 1. connected laptop by wired connection plugged in factory Jan 25, 2022 · Use DHCP Option 43 to provision your Unifi accesspoints if they are on different subnets than your controller. Connect your UniFi Security Gateway or UXG to a hosted controller by setting the inform URL, completing adoption, and confirming network access. PFSense has been my gateway for about 6 years. But what happens if post device adoption, the option 43 or DNS values are changed to point to a different IP? not sure how the home assistant is integrated but if you go into your controller system > advanced > inform host > check override and put your ip in there. 83, it has two USW Flex Mini adopted. Aug 10, 2020 · Use the full path to the set-inform command so your shell can find it. 4. The Solution I happened upon a /etc/persistent/cfg/mgmt file on the Unifi device, which Aug 4, 2021 · Setting the inform address for an Unifi device fails with “Status: Server Reject”. In order to find the full path, use Putty to run which set-inform. Congratulations, you now have two sites in your single controller, with all your Unifi devices! The theoretical risk of the DNS entry is that this is "known" and so any attacker could easily find your unifi controller with a simple DNS query and start hammering at it, while the DHCP option obfuscates it. 89, does not match my Unifi Controller’s address. If "info" command shows the set-inform URL is still the default of http://unifi:8080/inform, try factory resetting with "set-default" and then use the SSH adoption method. After spending hours troubleshooting I found this article -> for all those who were struggling to adopt their switch flex mini (no ssh) or are looking to not have to ssh into their devices when using a non-unifi router and a local or cloud controller, follow this guide: TCPIP Guide Seriously am so pleased with these. The way I typically do this is fire up the new Unifi equipment, find the IP address, use Putty to SSH into the equipment. Using putty to access this IP address and the default port 22 selected in putty I can get to the enter username and password part. I've downloaded the config from the AP and checked Dive into our ultimate guide for setting up and managing your UniFi Cloud Controller, complete with step-by-step instructions and essential tips. Streamline your network management. You can do this by accessing the device via SSH and using the set-inform command to view or set the correct URL. Oct 23, 2024 · Unifi SSH Commands: A Comprehensive Guide Even though Unifi devices come with a great controller, sometimes you need to access your Unifi device through SSH. Getting the USW Flex Mini adopted to HostiFi or any other cloud hosted UniFi Controller requires a few more steps. But what other SSH Commands are available for our Unifi devices? Using the open window for SSH, type in the set-inform URL, you can locate your HostiFi hostname from the portal, at app. Follow the steps to connect over SSH, set the inform URL, and complete the adoption in the controller. Wait for the 'Adopting' status to appear on the UniFi Controller, then issue the set-inform command again. local instead of the new set-inform. com. But sometimes you need more control. Jan 14, 2022 · Solve the Unifi Adoption Failed issue with these methods. Now there are a couple of ways to reset the UniFi Access Point. Learn how to use the "set inform" command to adopt UniFi devices to your network and the DHCP options to automate the process. Otherwise, the device will disconnect after appearing to adopt. 254 - Last night I set up a brand new AC-LR out of the box and it too had to be pointed in the right direction. Jan 20, 2022 · Even though Unifi devices come with a great controller, sometimes you need to access your Unifi device through SSH. In the Controller settings there's an option "Override inform host with Controller Hostname/IP" which will update the set-inform URL on all your devices with what's configured in the controller. How does it work? DHCP Serve DHCP 43 and/or unifi DNS can be used to configure set-inform on brand new Unifi devices for adoption and this works perfectly. Checking firmware version, inform url and more. Adoption failures, saying "managed by another console" when it does finally adopt, you name it. Devices will then “Discover” the controller IP from that. To remove APs from a Unifi Controller you need to reset the APs and then either discover them or manually SSH set-inform the devices. Locate the access point and click Adopt. Struggling to adopt a Unifi Express to a self-hosted controller. Sorry I wasn’t clear… In EdgeRouter I can set “UniFi Network IP” on the DHCP Server’s “Details” tab. Jul 17, 2020 · In this Tutorial I will be showing you how to adopt New Unifi Devices to your Unifi Cloud Controller using the SSH Method. I ran a Network test in Azure to verify communication from my public IP/8080 to the UniFi controller/8080 and it passed both directions. Essential SSH commands for UniFi device management, enhancing security and efficiency. To do this, you need to run a set-inform command while SSH'd into the devices. Archived post. New member here :) We have 6 AP working properly and for some reasons, all AP's are now showing "Offline" under the status column on the Unifi Controller Software. Here are the instructions for setting up Level 3 adoption via DHCP option 43 in OPNSense: Go to Services > DHCPv4 > [the relevant interface] > Additional Options > Advanced. Even though unifi devices come with a great controller,. As per checking, From the unifi controller 10. May 18, 2023 · This inform address, 192. Oct 4, 2018 · When your UniFi AP doesn’t respond anymore, or if you are unable to adopt it in the controller, then it’s a good idea to reset the UniFi AP back to factory defaults. 13. It there a way to revive them without having to Dec 26, 2020 · This article is about how to troulbleshoot ubiquiti unifi access point showing error as INFORM ERROR and not connecting to the controller. Aug 20, 2012 · In some circumstances there may be a need to manually tell a Unifi AP where to find its controller. . Aug 6, 2025 · The Inform Host Override setting tells UniFi devices where to “phone home” to reach the UniFi Controller. Visit the unifi site manager or unifi mobile app and click on the. Apr 12, 2017 · I read Cliff's guide to Ubiquiti UniFi with FreeNAS and Docker and not being able to adopt an AP because the Inform URL was wrong. The script will run and search for Ubiquiti devices on your network and display the results. local and the new site is unifi-14. You can reboot stuck devices, update firmware manually, or run troubleshooting commands you won’t find in the controller. 246) and vice versa tried to initiate ssh the one of AP and This is why you always set-inform twice. My quest seems similar to this post which I've tried to learn from. Obviously we could just update the DNS record to point to the new IP. Both units somehow disappeared from the controller. Therefore a single, ssh command must invoke mca-cli with set-inform as an argument. Step 1: SSH to your Unifi radio Jun 21, 2018 · This walkthrough goes over moving Unifi access point to another Unifi controller. We have a few devices we fight with this all the time for so here's the steps to fix. Read on to see how you can fix those issues! My ambitions to deploy UK Ultras to the exterior walls of the cabin were quickly dashed at realizing the cable runs would be challenging for the limited time available — cold weather prep was the priority — so I shoved one in the attic, replaced the nanoHD in the kitchen, and chucked that nanoHD into the “attic” space over the covered front deck. Login to the Unifi controller and navigate to Unifi Devices. In this video, I go over how to perform Layer 3 adoption with Unifi devices (specifically, Unifi access points). I'm also able to ping the controller from the switch when I SSH inside of it. Aug 10, 2018 · My customer has a UniFi controller running on their Windows server. Learn how to adopt a UniFi device to a remote or cloud-hosted UniFi Network Application using SSH or Mobile App. Replacing YOURURL with your HostiFi server URL, which can be found in your account, at app. The device UniFi inform over https? It seems to me that there are apparent security risks with using the default http inform URL for managing remote access points. Feb 19, 2025 · Requirements In order for your UniFi devices to reach the UniFi Cloud Controller, the following ports must be open in your firewall for outgoing communication: TCP port 8080: For management tasks and adoption (setting the controller parameter via the set-inform command). Feb 14, 2023 · Learn how to use SSH to set the adoption of Ubiquiti devices via the set-inform command when they have trouble adopting to the Unifi Controller. md) so you can read it easilly on github. The prerequisite to this process is you must know the IP address of the AP you need to modify. It's where you adopt devices, monitor networks, and make basic config changes. Basically, this is just how to get devices UniFi - Controller Hostname/IP and Override inform host settings HostiFi 5. This will permanently save the inform address, and the device will start provisioning. A UniFi device will execute commands and send another inform packet. But what other SSH commands are available for our Unifi devices? Ubiquiti has launched the $149 UniFi Express, which adds to the UXG-Lite a WiFi AP, a tiny screen, the ability to host its own UniFi controller or be adopted to an external one, and the flexibility to be used as just a router or AP, with or without wireless meshing. Most UniFi users stick to the web interface. Jan 13, 2022 · Learn how to use the Set-Inform command on an Unifi Access Point to tell it where the controller is located. Requests and responses share the same format encoded in big endian byte order. Just bought some Unifi gear for the house, have a self-hosted controller running in an Ubuntu server VM. May 15, 2018 · Hi, Currently moving some Unifi devices over to a cloud controller sitting in DO. net:8080/inform). Find the device IP address, connect to the device, and enter the command with the controller IP address. Resetting doesn’t work. Because Flex Mini doesn't support SSH, the usual manual set-inform method won't work. There's an public CNAME record set in my DNS provider Jun 7, 2022 · Fix the UniFi adoption error Server Reject by removing the device from the controller database manually. I am able to setup and import my settings. With that, everytime the Switch gets an IP address, the IP address of the inform host is added. Sometimes the Ubiquiti UniFi I have an access point (UAP-AC-Pro-Gen2) and a switch (US-8-60W). and one can set similar on other DHCP servers (I don’t use UniFi routers but I imagine similar ways of forcing controllers there). This happens on both units. This qualifies as a “remote adoption” or “L3 adoption. My laptop can access the UniFi Controller fine from the same public IP as this switch sits behind. I think I have the set inform url wrong on the second site (controller on default site). sometimes i see the Oct 4, 2020 · This guide will show you how to fix when your UniFi devices are randomly disconnecting or are stuck on adopting by overriding the inform host. 107 is able to ping all the AP (ex AP: 10. I was able to ssh into them successfully to try and initiate the set-inform command, but command no longer exists. ” I’ve spent several frustrating hours over a period of many days trying to get this to It'll automatically make itself available within UniFi. the devices are offline. Once logged into the UniFi AP, run the set-inform command. Tagged with networking, ubiquiti. 1, it's an Amplifi HD which I'm replacing with the Unifi Express. Controller is at 192. For some reason, enabling the "override inform host" option and entering the FQDN of my controller causes the adoption process to freak out. The strange thing was all AP has internet connectivity. Aug 7, 2025 · Sometimes UniFi devices fail to appear in the controller’s interface or cannot be adopted using the standard discovery methods. 101. Once you click adopt, the device will appear to go offline. Find out how to set the inform URL, username and password, and check the device status. However, it appears that it doesn’t show the link if you are not Owner. Fail-over was set to use . The device will show up for adoption on ALL sites in your UniFi controller, use the sites drop down in the upper right corner to switch to the site you want the device to be adopted in, then click "Adopt". We can use the physical reset button Must is use port 8080 for set-inform? I'm trying to run Unify Network in a container on a NAS. This tutorial explains how Unifi UAP device adoption works, how to adopt devices to the UniFi Network application, and how to troubleshoot any issues that may arise. if your manually updating the devices and they pull an update or a provision from the controller it will be overwritten every time till this is changed. There is currently only one payload version. This may be needed if you can’t provide the host name “unifi” in the DNS server for the subnet that the APs are located in. I have finally decided to move my home network to be segregated by VLANs. Sep 23, 2023 · I have installed the unifi controller app from the default store and from the truechart store. " I've mapped 8080 to 20001 because 8080 is a common port used by other apps also. 1) on the default site. May 18, 2021 · Ubiquiti UAP device adoption with UniFi network application and SSH terminal UniFi Device adoption is the process of connecting a UniFi device to a UniFi application in order to be managed by UniFi Controller. This will attempt to login to any devices on the designated subnet that have port 22 open and accept the default UniFi credentials. Main router is at 192. Script Bash para enviar o comando 'set-inform' automaticamente para APs UniFi via SSH, com log e truncamento automático. I got it working by setting the DHCP Option 43 on your DHCP-Server to the IP of your Unifi-Controller. Payload version 1 is JSON content and is the current version. this is if your using the "new ui". 3. The device will appear ready for adoption in the Controller. The thing is, when I use a laptop as the The HostiFi Device Discovery Tool supports adding a default inform URL, which means that any new UniFi devices added via the app, will always use that specified URL. That’s where SSH comes in. Recently I bought some new UniFi equipment for my home environment but I had some. This seems straightforward, but often times this is the issues. Once logged into the UniFi Switch, run the set-inform command. Check the Inform URL: Confirm that the device's inform URL matches the address of your UniFi Controller. 6K subscribers Subscribe Mar 22, 2023 · Today we will look at the Ubiquiti UniFi inform/adopt access point process. Jun 4, 2022 · The following Unifi SSh Commands can really help you with finding network-related issues with your Unifi Device. Step-by-step guide for adopting UniFi devices in Docker environments. Jul 21, 2021 · Passing a single command from ssh won’t invoke a full shell environment, and expect to find set-inform on a path, which of course doesn’t exist. By default, UniFi devices send inform packets to the controller that adopted them. In those cases, manually adopting a UniFi AP via SSH is often the fastest and most reliable solution. Unifi SSH Commands We are going to start with the most commonly used Unifi SSH Commands, later on, I will organize them by device or function. There are suggestions online saying that repeating set-inform several times to clear the backup configuration should stop the system from reverting to an incorrect address, but this approach has been unsuccessful for me. The concern is some devices may use an IP instead of FQDN for Ubiquiti - CLI - Cheat Sheet Unifi devices are running on a form of Linux, so most Linux commands will work on the devices. I also rebooted the controller last night. NOTE: The set-inform command must be issued twice. Type: string Value: “hex digits from calculator” Note the hex digits must be enclosed between quotation marks. And with the “debug tools Ubiquiti UniFi access points and gateways are great pieces of kit, and very reliable! But it can be frustrating when the lose connection to the controller. conf. However, Unify's docs say " TCP Port 8080 and UDP Port 10001 must be open for device adoption. local. Learn why UniFi devices go offline after updates, how to bring them back, and how to prevent future issues with static IPs, backups, and better controller setups. The process to be followed is:1. Learn how to adopt a UniFi device to the UniHosted free tier controller with our updated step-by-step guide. Once the device goes offline, issue the command set-inform in step 3 again. Find out the default credentials, best practices and considerations for secure and efficient UniFi management. Is there any way to get an access point to communicate with a controller using https? I haven't bought an SSL cert for it yet but I'm more than happy to if I know it'll work. Then there’s in the UniFi Network under Settings->Advanced->”Inform Host” which Jan 23, 2025 · In order to change the Inform URL in a Unifi device, first you have to SSH into it. This is a place to discuss all of Ubiquiti's products, such as the EdgeRouter, UniFi, AirFiber, etc. To set Oct 18, 2016 · I was able to get the actual inform url by SSHing into another AP that is recognized by the controller. but when i try to adapt any of the devices or use the mgrate from the old controller then it will not work. Find out the requirements, methods and troubleshooting tips for remote adoption. They’re ready to add a USG router, which I want to configure in my office before going on site. 250 now. Because the USW-Ultra doesn't support SSH, the usual manual set-inform method won't work. 168. May 18, 2023 · HI all, Ive got a self hosted L3 Unifi controller that will be getting migrated offsite soon, and I was wondering if there is a way to change the inform URL in bulk. After issuing the set-inform, the UniFi device will show up for adoption in the Devices section of the controller. Information about the reverse engineered inform protocol used in Ubiquiti's UniFi access points Keeping this really simple, everything is in this file (README. Mar 19, 2025 · Learn how to resolve UniFi device adoption issues, including SSH key errors and inform URL problems. If you choose to run the set-inform command, follow the prompts to enter the required information, such as your UniFi controller's IP/FQDN and optional custom SSH credentials. The TLDR is to update your routers custom DHCP options using Option 43 to Nov 1, 2018 · NOTE: The set-inform command must be issued twice. Feb 1, 2023 · What is the format for the UniFi Network Cloud inform URL? The format for the UniFi inform URL should be similar to the following a38927b1-23aa-e95d-94b4-8394abce9302. For example, to set up the initial connection, with the set-inform command. mycompanyunifiserver. unifi-hosting. Learn how to adopt your Unifi devices to your hosted controller using SSH, mobile app, or Chrome web browser. The format will be mxxxxxx. domain. UniFi - Device Adoption A doption is the process of connecting a UniFi device—such as an Access Point (AP), camera, switch, or sensor—to the UniFi Gateway and the UniFi application that will manage it. For example, to set up the initial connection with the set-inform command. So we're trying to separate out our unifi deployment so each sub-site has it's own controller. This way all the existing configuration of the access point is removed, allowing you to adopt the AP to your controller. Web Development Tools to the For UniFi Networking products this can be worked-around by having the UniFi Controller cache the firmware prior to upgrading — see Settings -> Maintenance -> Firmware. This is an issue I have had a couple of times. Once there I use the set-inform command to tell the equipment where to look for adoption using a FQDM (unifi. When reading, inform packets are decrypted before decompression, inverse is true for writing. SSH in to the Unifi Access Point using the default ubnt / ubnt password Hint: if the AP isn’t brand new and you’re trying to fix it via SSH you will need to find the username and the password from the old controller. We would like to show you a description here but the site won’t allow us. How you accomplish that I leave to you. X. I have multiple physically distinct sites, they all work great with my external inform url. Sometimes, you might need to issue the set-inform command a couple of times if the AP doesn't appear in the Controller immediately. It looks like this; set-inform http: USW Flex Mini change "set-inform" url without a working controller connection? Tl:dr I need to redirect a provisioned Mini to talk to a controller on a VLAN that doesn't exist until the switch is provisioned. Adoption is the process of connecting a device to the unifi application that will manage it. The DHCP Server on UniFi Gateways dynamically assigns IP addresses to devices and provides other information such as the location of the default gateway and DNS server. Click Adopt. hostifi. For more detailed information about how to SSH into a UniFi AP, see our guide here. Adopting those was easy, just plug and play. ui. This guide walks you through the full process. Jun 17, 2023 · Ubiquiti UniFi Access Point U6 Lite Hub Computers Unifi Access Point Set Inform To set the inform url you will need to run the command: By following the steps outlined in. Where are you running set-inform? You're supposed to run it in SSH on the Unifi devices you're adopting to the UDM (APs, switches, etc). 250 I then lost connection to the controller for all the unifi devices and had to SSH into all devices and set-inform to . Aug 28, 2018 · After issuing the set-inform, the UniFi device will show up for adoption. SSH gives you command-line access to your UniFi APs. Once you click Adopt, the device will appear to go offline or have the status of "Adopting". Additionally unifi stores the last "working" set-inform option and falls back to unifi:8080 in the event you misconfigured something. You don't run it on the UDM itself. In more complex environments—such as hosted controllers, NATed environments, or when migrating controllers; you may need to override the default behavior. We have devices that will be talking to our controller over the public Internet. May 25, 2022 · Navigate the process of adopting UniFi devices into your controller using SSH with Jaydien's comprehensive guide. Each AP does get moved by changing the set-inform multiple times but once they restart they go back to the original unifi. How to upgrade UniFi device firmware via SSH Useful if your device won't appear in UniFi after set-inform Written by Alex Lowe Updated over 2 months ago Aug 23, 2013 · The AP will by default try to reach unifi:8080/inform, if you do not have a DNS A record for “unifi” pointing to the IP address of your controller you will need to issue the following command once you have the new IP of the AP. 2. " I typed info and it returns the same. So I thought I would start to document the resolutions as and when it happens. - Eliseu-22/set-inform-unifi Have tried: set-inform many times in a row mcacli then set-inform many times adding a static route Any time my controller updates or I have a power cycle it always goes back into adopting status and I have to redo the set inform with the local ip. Oct 5, 2020 · Factory reset your other devices on site 2, ssh into them and run set-inform to the remote controller, adopt them and move them into the second site. Dec 11, 2023 · For UniFi Networking products this can be worked-around by having the UniFi Controller cache the firmware prior to upgrading — see Settings -> Maintenance -> Firmware. Jul 17, 2020 · In this Tutorial I will be showing you how to adopt New Unifi Devices to your Unifi Cloud Controller. 105. I tried the DNS name, the IP, https/http, 8080, 8443… I tried every form of url I could think of, but set-inform does not work. Most UniFi devices adopt automatically with no manual configuration. stxsp qvbt buahfk y76 zqcpqe gowbe mvntma crf 3yxuu3n auwpgx
