Fix Unifi Adoption Failed with these Easy to Follow Steps

Adopting an Unifi Access Point in the controller should be really straightforward. But sometimes it just won’t work. You keep getting Adoption Failed, or maybe even not able to adopt your access point at all.

The first step is to make sure that the inform URL is set correctly in the access point. But if that is set correctly then we need to take a different approach to fix the Unifi Adoption Failed issue.

In this article, I will explain different solutions to will help you to fix the adoption issue.

Why is the Unifi Adoption Failing

First a little bit of background information about why the adoption could be failing. There are a couple of things required to successfully adopt an Unifi Access Point in your controller:

  • The access point must not be managed by another controller
  • Inform url should be set correctly – read more about it here
  • Access Point firmware version should not be to old
  • Controller should be up-to-date

The most common issue is a firmware mismatch. The access point is for example running the latest firmware version, but the controller is maybe 10 releases behind. This could cause problems with adopting the access point.

Fix Unifi Adoption Failed

Method 1 – Factory Reset the Access Point

To make sure that the access point isn’t managed by another (old) controller, we are first going to factory reset the access point. Make sure that the access point is powered on and press the reset button for 10 seconds.

Another way to reset the access point is remotely with SSH.

  1. Connect to the access point over SSH (using PowerShell for example)
  2. Enter the following command to factory reset the AP:

You can reconnect to the access point after the Clearing CFG (configuration) is done.

With the Access Point reset you can now check if you can adopt the access point in the controller.

Method 2 – Check IP Address of the Access Point

After you have factory reset the access point, you should at least see the access point in the controller. If you don’t see it at all, then it’s possible that the IP range of the access point doesn’t match with the controller.

They both need to be in the same IP Range to be able to communicate with each other. You can use the Unifi Discovery Tool to scan your whole network for the access point. This way you can determine which IP Address the access point has got.

Unifi Discovery Tool
Unifi Discovery Tool

You might need to click the Unifi Family button in the top right corner to switch to the correct view.

If the access point is in a different IP range, then double-check your router and Unifi Controller to be sure that only one them has DHCP enabled. Another good option is to connect the access point to the same switch as the controller.

Method 3 – Update the Unifi Controller

Before we update the firmware of the access point, we are first going to make sure that Unifi Controller is up-to-date.

If you have a Cloudkey or UDM (Pro)

  1. Open your Unifi OS
  2. Go to Settings > Updates
  3. Check the Network application is up-to-date
unifi adoption failed

If you are running the controller in a Docker container or on Windows then check the version that you are running in the settings screen:

  1. Open the network controller
  2. Click on Settings
  3. Note the version and check the latest available version here
Unifi controller build number

After you have updated the Unifi Controller, try again to adopt the Access Point.

Method 4 – Update the firmware on the Access Point

If the firmware on the access point is outdated, then you also won’t be able to adopt the access point in the Unifi Controller. Normally you update the firmware through the controller, but there is another option.

We can manually download the Unifi firmware on the access point directly. To do this we are going to connect to the access point over SSH. You will need to know the IP Address of the access point, if you don’t see the IP Address in the controller, then use Advanced IP Scanner to look it up.

  1. Press Windows Key + X (or right-click the startmenu) and choose Windows PowerShell
  2. Connect to your access point. Replace the IP Adres below with the address of your access point:
# Connect to the access point, with username ubnt
ssh [email protected]

# type yes on the following warning:
The authenticity of host ' (' can't be established.
RSA key fingerprint is SHA256:dR0P62KnusGClIgPM1pfsx1QlH6HzrgTLxz0wDk2D4k.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
  1. Enter the password ubnt
  2. We now need to find the correct firmware URL. Open the Unifi download page and find the firmware for your access point.
  3. Click Download and accept the terms.
  4. Click Copy URL
Unifi firmware
  1. In the PowerShell Windows, type upgrade and paste the URL that we just copied:
Fix unifi adoption failed

The access point will download the firmware and upgrade it. During the upgrade, you won’t be able to connect to the access point. It can take a couple of minutes to complete.

You should be able to adopt the Unifi Access point when the upgrade is completed and the status light is solid white.

Adopt unifi access point

Wrapping Up

I hope this article helped you to fix the Unifi adoption failed issue. A factory reset is most of the time needed and make sure that you check your firmware versions. If you are running the controller in a docker container, then make sure that the appropriate ports are forwarded.

In docker, it can help to add the --net=host flag to the docker run command.

If you have any questions, just drop a comment below.

Get more stuff like this

IT, Office365, Smart Home, PowerShell and Blogging Tips

I hate spam to, so you can unsubscribe at any time.

28 thoughts on “Fix Unifi Adoption Failed with these Easy to Follow Steps”

  1. I recently purchased a second-hand Ubiquiti UniFi UAP-AC-PRO-Dual Radio Access Point, but I’m encountering adoption issues. After attempting to reset the device and initiate the adoption process, it’s requesting the previous owner’s username and password, which I don’t have access to. Could someone assist me in successfully adopting this device?

  2. Hi Rudy

    i’m a newcommer to your fantasic blog.

    while i was starting to write this comment, meaning to ask for help i realized one thing a had not tryed yet. it worked.
    so instead i’d like to share the solution in case it’s not allready in here some where i havent looked yet.

    First of, my problem:
    “i am trying the hole docker concept for the first time and hit a bit of trouble with the inform configuration, resulting in failed adoption.

    the unifi docker container is running in OpenMediaVault and when i put in the ip, it returns with the docker network ip instead.

    UAP-AC-LR-BZ.6.5.62# set-inform
    UAP-AC-LR-BZ.6.5.62# info

    Model: UAP-AC-LR
    MAC Address: f0:9f:c2:f3:db:d3
    IP Address:
    Hostname: UAP-AC-LR
    Uptime: 18607 seconds
    NTP: Synchronized

    Status: Timeout (”

    Second, my solution:
    i had allready prepared a proxymanager, and figured if i created a proxy host with the “domain” []
    and the destination []
    Maybe that would make way for the communikation?
    I was right, 10-15 seconds later, the AP was adopted and “online”.

  3. My access points in unifi controller doing adoption after some days , even after doing reset of the AP it works but after some days the same thing happens. This makes my internet connection to say that is connected but no internet ,
    Kindly help here since have got clients in the conference halls.

  4. Great article as per usual! Seems I’m always coming back to your blog for concise guides which you would otherwise have to trawl the UI forums for hours to ascertain.

    • Twice now 🙂
      I had two devices in adopting loop.

      What worked for me was to do a firmware upgrade

  5. Going to try the firmware tomorrow but it should be ok, the device was bought new a few weeks ago. I’m using the controller installed on a laptop, I don’t have any Ubiquiti devices other than access points.
    So far it’s not just failing to adopt, it’s not even showing up in the controller. The status LED on the access points flash a few times, then go solid white. Tried two different network switches just to be sure but no joy.
    Frustrating day. Previous experience with Ubiquiti had been great, plug and play and rock solid.

  6. Hi, thank you for your info; unfortunately id didn t worked for me. I reset several times the AP and the switch. I can see both on the controller but it can t be adopted. I updated the firmware over the ssh method. The controller is the last version. I restarted the controller several times(installed on ubuntu) Do you have any new ideas? Thank you for your support!

  7. I am trying to update my AP via ssh, but the password ubnt is denied. Is there a newer (or perhaps older password)? I also tried the password for the controller, but that wasn’t accepted either…

  8. This just saved our ass. Thank you for this thorough breakdown and step-by-step on doing the manual update, as our USG would not connect to our cloud key after a cloud key corruption. Would love to send you a tip for this!

  9. My power went out, therefore my internet went out. Power came back, but internet was delayed. I took advantage of this time to switch out a faulty access point but unfortunately, my ISP was still down. So it attempted to adopt and update without internet access. I tried to factory reset and it was stuck with adoption failed even after factory reset. Fortunately, restarting the controller after factory resetting appears to have the trick and is now letting me update properly with internet access. Just feedback in case someone else has the same problem.

  10. Bonjour

    j’ai re-initialisĂ© ma borne, mis a jour avec SSH.
    mais toujours serveur reject.
    je n’ai plus d’idĂ©e et j’ai 3 borne que je ne peux pas gĂ©rer.
    pouvez-vous me donner une autre idĂ©e, s’il vous plait.

  11. Thank you so insanely much for this. As a newcomer to Ubiquiti I was struggling a whole day. Your whole post helped get the adoption working.

  12. I had the same thign.
    i traced my steps back and remembered that the netwerk application was updated
    So rebooted the Cloudkey gen 2 and after that the adoption process was successful

  13. Adoption failed error when I changed my cloudkey to a different subnet and performed a set-inform. I can see in my logs that my dhcp server is issuing an IP address but the AP is not accepting so the dhcp just continues to re-issue the same address. The AP is in an awkward spot so I am trying to avoid have to perform a manual reset.

    I wish the Ubiquiti devs would just spend a little time updating the console to provide useful failure reasons. Adoption failed on its is own is unhelpful

  14. Try To download but This What Shown
    Invalid Head on[1] …
    Invalid Head on[2] …
    Storing Active[2] … [%100]
    cat: can’t open ‘/sys/class/net/up’: No such file or directory

  15. Thank you!

    After a nightmare struggle trying to adopt a USG to a Cloud Key Gen2, I found you excellent succinct post about it.

    Factory resets didn’t help until I upgraded the firmware via SSH as you suggested.

    What a relief! Thank you.

    Ubiquiti is completely insane @#$%, btw.

Leave a Comment