Recentemente eu tive a oportunidade de participar de um treinamento da TP-Link sobre o Omada, uma das soluções de redes corporativas baseadas no conceito de SDN que estão no mercado. E me interessou bastante a parte da controladora cloud para o gerenciamento dos equipamentos.
Logo mais soube deles que essa controladora você pode instalar em seu próprio hardware e então não perdi a oportunidade de testar, e esse aqui é um guia completo para você mesmo instalar em seu servidor.
Essa controladora cloud (Que no site da TP-Link é chamado de Controladora via Software é 100% 0800, quaisquer equipamentos que você comprar da série Omada, dos mais antigos aos mais recentes, você pode provisionar nessa controladora e sem precisar pagar licença de uso do equipamento.
No caso desse guia, eu criei uma VM no Proxmox, e fiz uma instalação limpa do Debian 12 (Futuramente teremos um guia aqui no site sobre isso) e seguindo a imagem abaixo, esses foram os recursos que coloquei nesta VM:
CPU: 4 vCPUs RAM: 8 GB Armazenamento: 32 GB
Feito essa instalação, podemos começar com os passos para a instalação.
PS: Essa versão da controladora omada é a 6.3.0.44, que até a data de publicação, era a versão mais recente da controladora
Configuração do Ambiente
Atualize seu Debian 12 e, se houver pacotes para fazer o upgrade, faça:
apt update
apt upgrade -y
Realize a instalação dos pacotes necessários:
apt install -y curl wget gnupg ca-certificates net-tools jsvc openjdk-17-jre-headless
Após a instalação, confira o Java:
java -version
Deve aparecer algo parecido com:
openjdk version "17.0.20.1" 2026-08-18
OpenJDK Runtime Environment (build 17.0.20.1+1-1-deb12u1-Debian)
OpenJDK 64-Bit Server VM (build 17.0.20.1+1-1-deb12u1-Debian, mixed mode, sharing)
Defina também o JAVA_HOME para a instalação:
export JAVA_HOME="$(dirname "$(dirname "$(readlink -f "$(command -v java)")")")"
echo $JAVA_HOME
Deve mostrar como resposta isso:
/usr/lib/jvm/java-17-openjdk-amd64
Confirme o jsvc
/usr/lib/jvm/java-17-openjdk-amd64
Deve retornar algo do tipo:
/usr/bin/jsvc
ii jsvc 1.0.15-10 amd64 Wrapper to launch Java applications as daemons
Instalação Mongo DB
O Omada atual suporta MongoDB de 3.6 até 8.0, e o MongoDB 8.0 oferece pacote oficial para Debian 12
Vamos importar a chave:
curl -fsSL https://pgp.mongodb.com/server-8.0.asc | \
gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \
--dearmor
Adicione o repositório:
echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/debian bookworm/mongodb-org/8.0 main" \
> /etc/apt/sources.list.d/mongodb-org-8.0.list
Faça o update e instale o Mongo DB:
apt update
apt install -y mongodb-org
Inicie o Mongo DB e verifique se está tudo certo:
systemctl enable --now mongod && mongod --version
Em seguida:
systemctl status mongod --no-pager
Feito isso, está tudo certo para instalar o Omada Controller.
Você vai baixar o arquivo com a extensão .deb
O que eu baixei veio escrito como: Omada_Network_Application_v6.3.0.44_linux_x64_20260824155552.deb PS: O nome do arquivo que você baixar pode mudar, ai apenas altere o nome do arquivo para ficar igual ao seu cenário.
Para instalar ele:
dpkg -i Omada_Network_Application_v6.3.0.44_linux_x64_20260824155552.deb
No final deve ter algo como:
...
Started successfully.
You can visit http://localhost:8088 on this host to manage the wireless network.
Perfeito! Conseguiu instalar a controladora. Agora no navegador você acessa pelo IP que está na sua máquina, no meu caso aqui, eu configurei o IP na minha interface: 192.168.100.25, então eu coloco esse IP no lugar do localhost e a porta para acessar a controladora.