~# ./UniFi Server.sh
👨🏻💻A Instalação "Correta" no Debian/Ubuntu
Muita gente se perde instalando o UniFi Server (antigo UniFi Controller) porque tenta atalhos que quebram dependências, especialmente com o MongoDB.
Existe um "jeito certo" de fazer isso, seguindo as recomendações oficiais para garantir estabilidade e atualizações futuras.
Neste guia rápido, vamos configurar o repositório oficial da Ubiquiti e o banco de dados necessário em apenas 8 passos.
Pré-requisitos
- Um servidor com Debian 12 (Bookworm) ou Ubuntu 22.04/24.04.
- Acesso root ou usuário no grupo
sudo.
Passo 1: Preparação do Sistema
Antes de começar, garanta que seu sistema está atualizado e com os pacotes base necessários para gerenciar repositórios via HTTPS.
sudo apt update && sudo apt upgrade -y
sudo apt install gnupg curl sudo ca-certificates apt-transport-https -yPasso 2: Configurando o MongoDB 7.0
O Unifi Server depende do MongoDB. Para que a instalação seja limpa, precisamos adicionar a chave GPG e o repositório oficial do banco de dados.
Importando a chave GPG:
curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg --dearmorAdicionando o repositório:
echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] http://repo.mongodb.org/apt/debian bookworm/mongodb-org/7.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.listInstalando o MongoDB:
sudo apt-get update && sudo apt-get install -y mongodb-orgPasso 3: Instalando o UniFi Network Server
Agora que a base está pronta, adicionamos o repositório da própria Ubiquiti.
echo 'deb [ arch=amd64,arm64 ] https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.listAtualize a lista de pacotes e instale o Unifi:
sudo apt-get update && sudo apt-get install unifi -yPasso 4: Acesso ao Painel
Com a instalação concluída, o serviço iniciará automaticamente. Agora é só acessar via navegador:
URL: https://SEU_IP:8443Substitua "SEU_IP" pelo endereço local da sua máquina (ex: 192.168.1.254).
Simples assim!