Como configurar o UniFi Network como um Serviço do Windows

Por padrão, o controlador UniFi Network roda em primeiro plano via Launcher — o que significa que ele para quando o usuário fecha a janela ou faz logoff. Configurá-lo como Windows Service faz com que ele rode em segundo plano continuamente, iniciando automaticamente com o Windows, mesmo sem ninguém logado.

Dois modos de execução

Modo	Comportamento
Launcher (padrão)	Roda em primeiro plano, para com o logoff
Windows Service (avançado)	Roda em segundo plano, inicia com o Windows

Requisitos e notas importantes

• Aplicável às versões mais recentes do UniFi Network para Windows
• Compatível com Windows 10 e Windows 11 (não aplicável ao Windows Server)
• Libere as seguintes portas no Windows Firewall e antivírus:
  • TCP 8080 e TCP 8843 (gerenciamento)
  • UDP 10001 e UDP 3478 (descoberta e STUN)

Passo a passo

1. Backup e fechamento do Launcher atual

Se já houver uma versão do UniFi Network em execução, faça o download do arquivo de backup pelo painel do controlador antes de prosseguir. Depois feche o Launcher.

2. Baixe e instale a versão mais recente

Acesse a página de Downloads da Ubiquiti e baixe a versão mais recente do UniFi Network para Windows. Execute o instalador.

3. Instale o Java 17 (x64)

Durante a instalação, você será solicitado a instalar o Java. Selecione as opções corretas:

• Tipo: JRE
• Arquitetura: x64
• Versão: Java 17
• Formato: .msi

4. Configure a variável JAVA_HOME

Na tela de instalação personalizada (Custom Setup) do Java, localize a opção “Set JAVA_HOME variable” e selecione “Will be installed on local hard drive”.

Atenção: Se a variável JAVA_HOME não estiver configurada corretamente, a instalação do serviço falhará. Se tiver problemas, remova versões antigas do Java antes de instalar o Java 17.

5. Abra o Prompt de Comando como administrador

Clique em Iniciar, busque por cmd, clique com o botão direito e selecione Executar como administrador.

6. Navegue até a pasta do UniFi

cd "%UserProfile%\Ubiquiti UniFi"

7. Instale o serviço

java -jar lib\ace.jar installsvc

Aguarde a mensagem “Complete Installation” no log.

8. Inicie o serviço

java -jar lib\ace.jar startsvc

9. Acesse o controlador

Abra o navegador e acesse:

https://localhost:8443

Ou substitua localhost pelo IP da máquina para acessar de outro dispositivo na rede.

Verificando se o serviço está ativo

Abra o Gerenciador de Tarefas → Serviços e procure por UniFi. O status deve estar como Em execução.

Você também pode verificar via PowerShell:

Get-Service -Name "UniFi"

Para parar ou remover o serviço

java -jar lib\ace.jar stopsvc
java -jar lib\ace.jar uninstallsvc

---

Gerencia uma rede Wi-Fi UniFi e precisa de suporte? A Callister oferece Wi-Fi como Serviço com monitoramento e suporte especializado. Fale conosco.

Artigos relacionados

Segurança Como configurar o UniFi Network como um Serviço do Windows 22 de jun. de 2023 Segurança O que fazer se você estiver no meio de um ataque de Ransomware 12 de ago. de 2021 Segurança O que fazer se você estiver no meio de um ataque de Ransomware! 12 de ago. de 2021