Instalar o agente
Há duas formas de inscrever uma máquina, e a escolha depende de quantas você vai instalar.
| Forma | Serve para | Reutilizável |
|---|---|---|
| Token de inscrição | Uma máquina, teste rápido | Não — uso único, expira em 24h |
| Chave de site | A frota inteira de um cliente | Sim — a mesma chave inscreve N máquinas |
Ambas ficam em Instalar agente no painel do RMM.
Uma máquina: token de inscrição
- Acesse Instalar agente
- Clique em Gerar token de inscrição
- Copie o token e rode o instalador na máquina alvo
O token é trocado por uma identidade permanente da máquina, gravada em disco com permissão restrita. Depois disso o agente reconecta sozinho, sem token.
Ele vale para uma inscrição e expira em 24 horas. Para instalar em várias máquinas, use a chave de site — gerar um token por máquina é trabalho manual sem motivo.
A frota: chave de site
A chave de site é um segredo por site que inscreve quantas máquinas você quiser, e pode ser revogada a qualquer momento.
- Acesse Instalar agente
- Escolha o site (ou crie um em Sites)
- Clique em Criar chave de site
O servidor monta o comando de instalação com o endereço e a chave já preenchidos — não há nada a digitar na máquina do cliente.
Linux e macOS
Copie e cole como root:
curl -fsSL https://SEU-SERVIDOR/install/<CHAVE-DO-SITE>.sh | sudo sh
Windows
No PowerShell como administrador:
irm https://SEU-SERVIDOR/install/<CHAVE-DO-SITE>.ps1 | iex
O script baixa o agente, faz a inscrição e registra o serviço do sistema — Windows Service, systemd ou launchd, conforme a máquina.
Chave revogada para de inscrever máquinas novas (o download passa a devolver 404). As máquinas já inscritas continuam funcionando, porque elas usam a identidade própria, não a chave.
Windows em massa: MSI
MSI com a chave embutida (duplo clique)
Em Instalar agente, use baixar MSI (chave já embutida). É o instalador para mandar ao cliente: ele dá dois cliques e pronto — nada a digitar, nada a configurar.
MSI via GPO ou Intune
Para empurrar pela política de domínio ou pelo Intune, use o MSI genérico com a chave na linha de comando:
msiexec /i noxuscore-agent-amd64.msi NOXUS_SERVER=https://SEU-SERVIDOR NOXUS_SITEKEY=<CHAVE> /qn
O agente é instalado em Program Files\noxuscore, inscreve, registra o serviço e
inicia. A desinstalação remove o serviço.
A desinstalação não apaga %ProgramData%\noxuscore\agent.json, que é a
identidade do dispositivo. Reinstalar em cima mantém a mesma máquina no painel,
que é o comportamento desejado.
Para reinscrever do zero, apague essa pasta antes de reinstalar. E se você removeu o dispositivo no painel mas o arquivo sobrou na máquina, o agente fica com uma identidade órfã e não reconecta até o arquivo ser apagado.
Conferir se funcionou
- Acesse Dispositivos
- A máquina aparece com estado online em até um minuto
- Abra a máquina: sistema, versão, arquitetura e inventário de software preenchidos
Se ela não aparece:
| Sintoma | Causa provável |
|---|---|
| Nada aparece no painel | O serviço não subiu — confira o serviço noxusagent na máquina |
| Erro de inscrição | Chave revogada, ou token já usado / expirado |
| Máquina aparece e some | Duas instalações com a mesma identidade, ou o serviço reiniciando |
| Recusa com aviso de limite | O plano atingiu o número de máquinas contratadas |
Sistemas suportados
| Sistema | Situação |
|---|---|
| Windows 10, 11 e Server | Suportado, com instalador MSI |
| Ubuntu, Debian | Suportado (inventário por dpkg) |
| Fedora, RHEL, openSUSE | Suportado (inventário por rpm) |
| Alpine | Suportado (inventário por apk) |
| macOS Intel e Apple Silicon | Suportado (inventário por brew) |
O agente é um binário estático: roda na distro sem precisar de pacote próprio.
Parar serviço, instalar pacote e aplicar patch exigem o agente rodando como root ou SYSTEM — que é como o instalador o registra. Rodando como usuário comum, as listagens funcionam e as ações voltam erro de permissão.