Instalar um node
Objetivo
Seção intitulada “Objetivo”Cadastrar um ou vários nodes num cluster e instalar cada servidor com o comando gerado pelo painel.
Quem pode: quem tem Escrever no DNS Recursivo (Editor ou Gerente).
Antes de começar
Seção intitulada “Antes de começar”- Sistemas suportados: Debian 12, Debian 13 e Ubuntu 24.04 LTS. Use uma instalação limpa, de 64 bits, com acesso à internet para baixar os pacotes. Outras versões são recusadas na pré-checagem.
- O cluster já precisa existir. Veja Clusters, anycast e prefixos.
Passo a passo
Seção intitulada “Passo a passo”-
Abra Clusters, clique no cluster e abra a aba Nodes.

-
Em Adicionar nodes, preencha Hostname, IPv4, IPv6 e Porta SSH de cada node. Use + Linha para mais linhas e Tirar para apagar uma.
-
Para muitos nodes, clique em Colar CSV em vez disso e cole no campo Colar CSV uma linha por node, no formato
hostname,ipv4,ipv6,porta_ssh. O cabeçalho é opcional. Exemplo:hostname,ipv4,ipv6,porta_sshdns-01,198.51.100.11,2001:db8::11,22dns-02,198.51.100.12,,22
-
Clique em Revisar. O painel confere tudo e diz quantos nodes seriam criados, sem gravar nada.
-
Clique em Criar nodes. Se alguma linha tiver erro, nada é gravado e o erro aparece com o número da linha.
-
Em Comandos de instalação, os nodes ainda não instalados já vêm marcados na tabela. Clique em Gerar comandos dos selecionados. Para servidor com pouco hardware, marque antes Instalar mesmo se algum servidor tiver hardware insuficiente (fica registrado).

-
Para cada node, clique em Copiar e rode o comando como root no servidor. Sem curl, abra Sem curl no servidor? e use a outra opção. O painel mostra por quanto tempo o comando vale.
-
Para um node só, ou para reinstalar, abra o node, aba Instalação e ajustes, e clique em Gerar comando de instalação.
Resultado esperado
Seção intitulada “Resultado esperado”O comando faz a pré-checagem, instala BIND9, nftables, FRR e o agente, e aplica a configuração do cluster. O node passa por Pendente, Checando e Instalando até Ativo, e as métricas começam a chegar a cada 30 segundos. Cada comando vale 1 hora e funciona uma vez; gere outro quando precisar.
Se algo não der certo
Seção intitulada “Se algo não der certo”- “Hostname … inválido: letras minúsculas, números, hífen e ponto, até 63 caracteres entre pontos.” Corrija o nome nessa linha.
- “Hostname … repetido (linha N).” ou “Há IPs em conflito.” Cada node precisa de nome e IPs próprios.
- “Porta SSH inválida.” ou “Linha mal formada.” Confira a linha no formato
hostname,ipv4,ipv6,porta_ssh. - “No máximo 500 nodes por vez.” Divida a lista em partes.
- “Selecione os nodes na tabela.” Marque os nodes em Comandos de instalação.
- “Expirado: gere outro.” O comando passou de 1 hora. Gere um novo.
- O node fica com Falhou: confira o sistema operacional e o acesso à internet do servidor.