Skip to content

Devices stuck in Adopting using Docker Unifi Controller on Synology Diskstation

Published: March 7th, 2025 Tech Image of a DiskStation DS1621+ and a Ubiquiti UniFi U6+

I recently replaced an old WiFi router with an Ubiquiti UniFi U6+. I connected it to a Ubiquiti UniFi Switch Lite 8 PoE.

To manage Ubiquiti devices, you need the UniFi Network Application, which can be run from a dedicated device or from a Docker image. As you might know, I’m a big fan of running certain applications as Docker containers on my Synology DiskStation.

I have installed this Docker image with help from this guide. After starting the container, I could log in and start adopting my devices.

The devices were found, but remained stuck in the “Adopting” status. I did a factory reset for both devices, but nothing changed. After reading the documentation more thoroughly (#protip), I found an explanation.

Override "Inform Host" IP

For your Unifi devices to "find" the Unifi Controller running in Docker, you MUST override the Inform Host IP with the address of the Docker host computer. (By default, the Docker container usually gets the internal address 172.17.x.x while Unifi devices connect to the (external) address of the Docker host.) To do this:

  • Find Settings -> System -> Other Configuration -> Override Inform Host: in the Unifi Controller web GUI. (It's near the bottom of that page.)

  • Check the "Enable" box, and enter the IP address of the Docker host machine.

  • Save settings in Unifi Controller

  • Restart UniFi-in-Docker container

The above was copied from the docs.

Now my devices were adopted and I could continue setting them up and integrate them into the home network.

About Marcel Bootsman

Marcel discovered the web in 1995. Since then he has paid attention to and worked with lots of technologies and founded his own WordPress oriented business nostromo.nl in 2009.

Currently Marcel is Business Development Manager Dutch & DACH Markets at Kinsta where he helps Kinsta's client base grow with Managed WordPress, Application, Database and Static site hosting.

You can contact Marcel on a diverse range of online platforms. Please see the Connect section on the homepage for the details.