UniFi set-inform: como apontar o AP para a controladora correta.

O comando set-inform é utilizado principalmente em adoções Layer 3, controladoras self-hosted, migrações e cenários em que o AP não descobre automaticamente o UniFi Network. Ele não “força” a adoção sozinho: a comunicação de rede até a controladora ainda precisa funcionar.

Quando o set-inform é útil

Use quando AP e controladora estão em sub-redes diferentes, quando a descoberta automática não funciona ou após migrar uma controladora para outro endereço. Em uma rede local simples com console UniFi na mesma rede, normalmente a adoção automática é preferível.

Sintaxe básica

A sintaxe documentada pela Ubiquiti é set-inform http://IP-DO-HOST:8080/inform. Substitua o IP pelo endereço realmente alcançável do servidor/console que executa o UniFi Network. Em instalações com DNS bem configurado, também é possível utilizar FQDN.

Acesse o AP por SSH

Você precisa conhecer o IP e as credenciais SSH do dispositivo. Depois da conexão, execute o set-inform e volte para o UniFi Network para verificar se o AP aparece como pronto para adoção.

TCP 8080 precisa chegar ao host UniFi

Se a porta estiver bloqueada, o comando não resolverá. Em VLANs diferentes, verifique roteamento e firewall. Em adoção remota pela Internet, o host precisa estar realmente alcançável, seja por IP público/port forwarding, VPN ou arquitetura suportada.

Por que executar o comando novamente

A documentação da Ubiquiti informa que, em alguns fluxos, o set-inform pode precisar ser repetido após o equipamento aparecer na controladora. Isso completa a associação com o novo destino de gerenciamento.

Erros comuns

Apontar para IP privado inacessível, esquecer a porta 8080, publicar a porta para o servidor errado, tentar através de CGNAT sem VPN e manter uma regra de firewall bloqueando a comunicação são causas frequentes de insucesso.