Skip to main content
Implantar o agente de software (Myrmex Endpoint Security) em um host requer duas coisas: um token de instalação que você gera no console e o instalador ou comando por SO que o utiliza. Uma vez instalado, o agente se registra sozinho e aparece na sua lista de Endpoints como unauthorized — você o aprova para ativar o monitoramento.
Esta página trata do agente de software instalado. Os agentes de IA — Perseus para operações de endpoint e Brontes para gerenciamento de frota — são separados. Consulte Arquitetura do agente para entender como os dois se relacionam.

​
Gere um Token de Instalação

Toda instalação é autorizada por um token que você cria no console.
1

Abra Download Agent

No Directory, escolha a ação rápida Download Agent (ela também está na barra de atividades). O Myrmex abre a página em tela cheia Download Agent.
2

Crie o token

Gere um token de instalação. Ele é válido por 24 horas e é reutilizável — você pode instalar em quantas máquinas quiser durante esse período com o mesmo token.
3

Escolha sua plataforma

Escolha o sistema operacional no qual você está instalando. A página fornece um comando pronto para executar e um instalador para download, ambos pré-preenchidos com o seu token.
Trate o token de instalação como um segredo enquanto ele estiver válido. Quando ele expirar após 24 horas, basta gerar um novo.
Os comandos abaixo mostram o formato de cada método de instalação. Copie o comando exato — com o seu token e a URL de download corretos já preenchidos — a partir da página Download Agent, em vez de digitá-lo manualmente.

​
Windows

Requisitos: Windows 10 ou posterior, ou Windows Server 2016 ou posterior (64 bits), com direitos de administrador. Para versões mais antigas do Windows, há uma build legada separada de 32 bits disponível. Escolha um dos métodos:
  • Instalador MSI — baixe o MSI na página Download Agent e execute-o. Dê um duplo clique e siga o assistente, aprovando o prompt do Controle de Conta de Usuário, ou instale silenciosamente com msiexec.
  • Comando único do PowerShell — execute o comando da página em uma sessão elevada do PowerShell para baixar e instalar o agente em uma única etapa.

​
macOS

Requisitos: um Mac com Apple Silicon (arm64) e direitos de administrador. Escolha um dos métodos:
  • Instalador de pacote (.pkg) — baixe o .pkg assinado na página e execute-o.
  • Comando no Terminal — execute o comando bash da página para baixar e instalar o agente.

​
Linux

Requisitos: uma distribuição de 64 bits suportada com acesso root ou sudo. As distribuições suportadas incluem:

Família Debian / Ubuntu

Debian, Ubuntu e Linux Mint.

Família RHEL / Fedora

Fedora, Red Hat Enterprise Linux, CentOS, Oracle Linux e Amazon Linux.
Há builds disponíveis para as arquiteturas amd64, x86 e arm64. Instale com o instalador universal. É um único comando curl | bash que lê o seu token de instalação a partir de uma variável de ambiente, detecta a distribuição e instala o pacote correto:

​
Autorize o Novo Dispositivo

Depois que o instalador terminar, o agente se registra na plataforma e o dispositivo aparece na sua frota — online, mas não autorizado. Essa aprovação manual é uma barreira de segurança deliberada: um token válido faz um dispositivo ser registrado, mas uma pessoa ainda precisa aprová-lo antes que ele seja confiável.
1

Encontre o novo dispositivo

Abra a visão de Endpoints. O novo host aparece com um badge unauthorized.
2

Autorize-o

Abra sua visão de detalhes do dispositivo e escolha Authorize. A coleta de telemetria e as ações de resposta são ativadas assim que ele é aprovado.
Você também pode definir o papel de um dispositivo — Agent ou Collector — a partir de sua visão de detalhes. Consulte Modo Endpoint e Modo Collector.

​
Migrar um Host Entre Contextos

Um contexto é a organização / tenant para a qual um host reporta. Para mover um host já instalado de um contexto para outro você não desinstala nada — basta reexecutar o instalador com o token do novo contexto, e o agente refaz o vínculo sozinho.
1

Pegue o comando de instalação do novo contexto

Entre no contexto de destino e abra a página Download Agent dele. Gere um token de instalação ali e copie o comando pronto para executar — ele já é específico daquele contexto.
2

Execute no host

Rode esse mesmo comando no host, como root / administrador — o mesmo comando de uma instalação nova. O agente se re-registra no novo contexto: obtém uma nova identidade, reescreve config.yml / env.conf apontando para o novo contexto e reconecta. Não é preciso desinstalar nem reiniciar.
3

Autorize no novo contexto

O host aparece na visão de Endpoints do novo contexto como unauthorized. Aprove-o ali para reativar a telemetria e a resposta. No contexto antigo ele para de reportar e pode ser removido.
Nenhuma integração é migrada com isso. As integrações pertencem ao contexto — vivem na plataforma, não no host — então re-vincular um host move apenas o agente daquele host. Não copia, move nem apaga nenhuma integração: o contexto antigo mantém suas integrações, e o novo usa o que estiver configurado nele.
Reexecutar o instalador apenas sobrescreve o vínculo de contexto do host (config.yml / env.conf) com o do novo contexto — é isso que constitui a migração. O binário do agente e seus serviços permanecem no lugar.

​
Atualizações Automáticas

Você não precisa reinstalar para se manter atualizado. Um processo supervisor mantém o agente atualizado com atualizações silenciosas e automáticas, e as novas versões são disponibilizadas gradualmente para minimizar interrupções.