- Redes
- Sistema UniFi
Adoption Failed
Ubiquiti UniFi Adoption Failed: el equipo no se adopta
Nivel de riesgo
Precaución
Actúa con cuidado; puede requerir técnico si persiste.
Urgencia
Alta — no esperes
Respuesta rápida
Si un punto de acceso o switch muestra Adoption Failed en Ubiquiti UniFi, revisa que tenga una IP válida por DHCP (y no la IP de respaldo 192.168.1.20), que los puertos TCP 8080 y UDP 10001 estén abiertos hacia el controlador y si figura como Managed by Other antes de restablecerlo.
Seguridad primero
Antes de continuar
- El restablecimiento a valores de fábrica (Forget/Unmanage o pulsar el botón Reset de 5 a 10 segundos) borra la configuración del dispositivo UniFi y deja sin servicio a quienes dependen de ese punto de acceso o switch: úsalo solo como último recurso y avisa antes a los usuarios de la red.
- Mantén el dispositivo alimentado durante todo el restablecimiento de fábrica y pulsa el botón Reset entre 5 y 10 segundos: pulsarlo menos tiempo solo lo reinicia y pulsarlo demasiado tiempo lo envía al modo TFTP Recovery.
Puedes hacerlo con seguridad
- Inspeccionar el estado del LED del dispositivo antes de tocar la configuración
- Verificar la dirección IP asignada en IP Leases, WiFiman o conectando un portátil al cable
- Comprobar que TCP 8080 y UDP 10001 no estén bloqueados en firewalls ni entre VLAN
- Restablecer a valores de fábrica solo como último recurso manteniendo la alimentación
Deja estas tareas a un profesional cualificado
- No intentes esta tarea profesional: Configuración de adopción de capa 3 (SSH set-inform, DHCP Option 43 o DNS) por el administrador de red
- No intentes esta tarea profesional: Resolución de etiquetado de puertos VLAN, bucles o servidores DHCP intrusos en la infraestructura
Lo que un técnico debe poder justificar
Viene un técnico
Estos son los pasos que tiene que hacer y enseñarte. Márcalos mientras trabaja: si se salta pasos, no aceptes el cambio de pieza.
No son instrucciones para que abras o manipules el equipo. Son las comprobaciones que deben sostener una conclusión técnica.
Configuración de adopción de capa 3 (SSH set-inform, DHCP Option 43 o DNS) por el administrador de red
Qué haceCuando el dispositivo UniFi y el controlador residen en distintas VLAN o sedes remotas, el administrador debe configurar el método de descubrimiento de capa 3 documentado por Ubiquiti.
Te tiene que enseñarla respuesta del comando set-inform o la configuración de Option 43/DNS y el estado Online del equipo en UniFi Network.
Por escritola URL inform configurada, las reglas de puerto/VLAN aplicadas y a qué usuarios se notificó la ventana de cambio.
Resolución de etiquetado de puertos VLAN, bucles o servidores DHCP intrusos en la infraestructura
Qué haceSi el dispositivo cae repetidamente en la IP de respaldo 192.168.1.20 o recibe concesiones de otro rango, el administrador de red debe auditar los switches y el servicio DHCP.
Te tiene que enseñarla concesión válida en Settings > Networks > IP Leases y el perfil de VLAN asignado al puerto del switch.
Por escritoel puerto del switch corregido, la subred asignada y la confirmación de alcance al puerto TCP 8080.
Antes de aceptar una pieza o reparación
Aún no ha demostrado nada. No aceptes un cambio de pieza solo por el código.
Sigue estos pasos
Aviso: Sigue el orden documentado. Un código identifica el sistema afectado, pero por sí solo no demuestra qué pieza está averiada.
Inspeccionar el estado del LED del dispositivo antes de tocar la configuración
- Quién:
- Persona usuaria o responsable local de la instalación, sin desmontar el equipo ni desconectar otros servicios sin avisar.
- Cómo:
- Observa el indicador luminoso del dispositivo UniFi: comprueba si está en blanco fijo (estado de fábrica listo para adoptar), si parpadea en azul apagándose cada 5 segundos (sin conectividad de red) o si no enciende.
- Resultado que importa:
- Identificación visual de si el dispositivo está en valores de fábrica y con enlace físico.
- Si el LED parpadea en azul cada 5 segundos o está apagado, confirma un problema de conectividad o alimentación previa a la adopción.
- Si el LED luce en blanco fijo pero la adopción falla en la interfaz, indica que el equipo espera adopción y debes verificar su dirección IP y el puerto TCP 8080.
- Evidencia a conservar:
- Anota el patrón exacto del LED y el puerto del switch al que está conectado el cable.
Evidencia: UniFi device connectivity troubleshooting · UniFi - Remote Adoption (Layer 3)
Verificar la dirección IP asignada en IP Leases, WiFiman o conectando un portátil al cable
- Quién:
- Persona administradora de la red local con acceso a UniFi Network o a la app móvil WiFiman.
- Cómo:
- En UniFi Network entra en Settings > Networks y abre IP Leases en la red correspondiente, o busca el equipo en la pestaña Discovery de la app WiFiman; si no aparece, conecta un portátil al mismo cable y puerto para ver si recibe IP válida o cae en 192.168.1.20 o en APIPA (169.254.xxx.xxx).
- Resultado que importa:
- Dirección IP válida dentro de la subred prevista, sin caer en 192.168.1.20 ni en 169.254.x.x.
- Si el equipo muestra la IP de respaldo 192.168.1.20, carece de IP o recibe otra subred, confirma un fallo de etiquetado VLAN del puerto, bucle de red o servidor DHCP intruso.
- Si recibe una IP válida de la red esperada, descarta el fallo de DHCP y pasa a comprobar el alcance por TCP 8080.
- Evidencia a conservar:
- Guarda una captura de la lista IP Leases o de la pestaña Discovery de WiFiman con la IP y la MAC.
Si desconectas el punto de acceso o switch para probar el cable con un portátil, avisa antes a los usuarios de esa zona porque interrumpirás su servicio de red.
Evidencia: UniFi device connectivity troubleshooting
Comprobar que TCP 8080 y UDP 10001 no estén bloqueados en firewalls ni entre VLAN
- Quién:
- Persona administradora del controlador UniFi o del cortafuegos local.
- Cómo:
- Revisa el firewall y el antivirus del host donde corre UniFi Network (si es autoalojado) y las reglas entre VLAN del gateway para asegurar que el tráfico TCP 8080 y UDP 10001 llega desde la subred del dispositivo hasta el host UniFi.
- Resultado que importa:
- Conectividad abierta en TCP 8080 y UDP 10001 entre el dispositivo UniFi y el controlador.
- Si un firewall del sistema operativo o una regla entre VLAN bloqueaba el puerto 8080 y al abrirlo el equipo se adopta, confirma esa causa.
- Si los puertos están abiertos y el equipo figura como Managed by Other o en otra subred sin descubrirse, indica que requiere reasignación, comando set-inform o restablecimiento de fábrica.
- Evidencia a conservar:
- Conserva captura de las reglas de firewall o del ajuste de red revisado.
Cualquier cambio en reglas de VLAN, enrutamiento o cortafuegos afecta a todos los usuarios conectados a la red: coordínalo con el responsable del sistema y no expongas puertos de gestión sin control.
Evidencia: UniFi device adoption guide · UniFi device connectivity troubleshooting · UniFi - Remote Adoption (Layer 3)
Restablecer a valores de fábrica solo como último recurso manteniendo la alimentación
- Quién:
- Persona administradora tras avisar a los usuarios afectados y confirmar que la configuración previa puede borrarse.
- Cómo:
- Si el equipo sigue en Managed by Other o no adopta tras validar IP y puerto 8080, elimínalo primero desde Manage > Forget (UniFi Network) o Unmanage (Protect) si aparece en la consola, o mantén pulsado el botón físico Reset entre 5 y 10 segundos con el equipo encendido hasta que los LED indiquen el inicio de la restauración.
- Resultado que importa:
- El equipo se reinicia con el LED en blanco fijo, listo para una adopción limpia.
- Si tras olvidar el registro antiguo y pulsar Reset de 5 a 10 segundos se adopta con normalidad, confirma que retenía un estado de gestión previo.
- Si no restaura o entra en modo TFTP Recovery por pulsar demasiado tiempo, indica que debes revisar la guía de estados LED o el soporte de Ubiquiti.
- Evidencia a conservar:
- Registra la hora del restablecimiento y haz captura del dispositivo ya adoptado en UniFi Network.
Evidencia: UniFi device adoption guide · UniFi factory reset instructions
Situación no resuelta
Si el error persiste, no sigas probando por tu cuenta. Mira qué tiene que hacer y enseñarte el técnico.
Dónde se aplica este código
Un código solo tiene significado dentro del producto y la versión correctos.
Ámbito principal
- Sistema
- Redes
- Marca
- Ubiquiti
- Tipo de producto
- Sistema UniFi
Variantes conocidas del código
- Échec adoption Ubiquiti
- Ubiquiti adoption failed
- Ubiquiti Adoption fehlgeschlagen
- UniFi Adoption Failed
- UniFi device not adopting
- UniFi ne s’adopte pas
- UniFi no adopta
- UniFi-Gerät wird nicht übernommen
Qué significa
En el ecosistema Ubiquiti UniFi, la adopción vincula un punto de acceso, switch, cámara o sensor con la aplicación UniFi Network. Cuando el proceso falla (Adoption Failed), la guía oficial señala cuatro causas principales: ausencia de concesión DHCP válida (quedando el equipo en la IP de respaldo 192.168.1.20 o en APIPA 169.254.x.x por etiquetas de VLAN, bucles o un servidor DHCP intruso), bloqueo del puerto de informe TCP 8080 o de descubrimiento UDP 10001 en cortafuegos o entre VLAN, falta de ruta Layer 3 (SSH set-inform, opción DHCP 43 o DNS) o vínculo previo a otra consola (Managed by Other). El aviso no prueba una avería física del dispositivo.
Advertencias y condiciones de parada
- Atención altaadvertencia editorial
El restablecimiento a valores de fábrica (Forget/Unmanage o pulsar el botón Reset de 5 a 10 segundos) borra la configuración del dispositivo UniFi y deja sin servicio a quienes dependen de ese punto de acceso o switch: úsalo solo como último recurso y avisa antes a los usuarios de la red.
Evidencia: UniFi device adoption guide · UniFi factory reset instructions
- Precauciónverificada con fuente
Mantén el dispositivo alimentado durante todo el restablecimiento de fábrica y pulsa el botón Reset entre 5 y 10 segundos: pulsarlo menos tiempo solo lo reinicia y pulsarlo demasiado tiempo lo envía al modo TFTP Recovery.
Evidencia: UniFi factory reset instructions
Síntomas y causas
Causas probables · en orden
- Falta de concesión DHCP válida o caída en la IP de respaldo 192.168.1.20Confirmada
Si el puerto del switch tiene un etiquetado de VLAN erróneo, existe un bucle de red, actúa un servidor DHCP intruso (Rogue DHCP) o falla el DHCP, el equipo queda sin IP, con dirección APIPA (169.254.x.x) o en la IP de respaldo 192.168.1.20.
Evidencia: UniFi device connectivity troubleshooting
- Bloqueo del puerto TCP 8080 o UDP 10001 en cortafuegos, antivirus o entre VLANFrecuente
Para adoptar en la misma VLAN, Ubiquiti exige tener abiertos TCP 8080 y UDP 10001 en pasarelas, firewalls y antivirus locales; entre subredes o en la nube, el dispositivo y UniFi Network deben comunicarse sin restricciones por TCP 8080.
Evidencia: UniFi device adoption guide · UniFi device connectivity troubleshooting · UniFi - Remote Adoption (Layer 3)
- Dispositivo asociado a una consola anterior (estado Managed by Other)Posible
Cuando el equipo estuvo gestionado por otra instancia de UniFi Network o se restauró la consola sin olvidarlo antes, conserva el vínculo antiguo y rechaza una adopción nueva hasta reasignarlo, restaurar copia o restablecerlo de fábrica.
Evidencia: UniFi factory reset instructions
- Adopción remota de capa 3 sin URL inform alcanzable o detrás de doble NATPosible
En despliegues donde el controlador está en otra VLAN o sede, la adopción falla si no se define la ruta mediante la aplicación móvil en la misma VLAN, SSH set-inform, DHCP Option 43 o DNS, o si la consola remota está tras doble NAT con IP privada.
Evidencia: UniFi device adoption guide · UniFi - Remote Adoption (Layer 3)
Técnico virtual
¿Sigue apareciendo Adoption Failed tras comprobarlo?
Responde unas preguntas para acotar la causa probable y la siguiente acción segura. Es una orientación - nunca sustituye a un profesional.
Fuentes y referencias técnicas
- 1
Ubiquiti · 2026 · official_doc
- 2
UniFi device connectivity troubleshooting
Ubiquiti · 2026 · official_doc
- 3
UniFi factory reset instructions
Ubiquiti · 2026 · official_doc
¿Te ha resultado útil esta ficha?