// DEPLOY_PROTOCOL
Instale o Yami EDR
Baixe, suba em minutos e comece a monitorar. Plano Essencial grátis — licença só para upgrade.
01 Download
- Arquivo
- Yami-EDR-release.zip
- SHA-256
d4503f1011bdee82bceb4014f35c4464d1ecc150d1fc52f7d18857161083d6f4
Atenção Confira o SHA-256 antes de instalar. O plano Essencial (gratuito) já vem ligado; a licença é só para Pro/Enterprise.
02 Pré-requisitos
- Sistema
- Servidor Debian 12 ou Ubuntu 22.04+
- Via Zip
- python3 (3.10+) e unzip
- Via Docker
- Docker + Docker Compose
- Mínimo
- 1 vCPU / 1 GB RAM / 5 GB disco · porta 8787 (ou atrás de proxy)
03 Passo a passo
Via Zip
Instalação manual como serviço do sistema (systemd). Comandos como root ou com sudo.
-
01
Baixar o release + o checksum
cd /opt curl -fsSLO https://yamiedr.com/downloads/Yami-EDR-release.zip curl -fsSLO https://yamiedr.com/downloads/Yami-EDR-release.zip.sha256 -
02
Conferir a integridade
sha256sum -c Yami-EDR-release.zip.sha256saída esperada:
Yami-EDR-release.zip: OKPrecisa dizer OK. Se aparecer FAILED, pare aqui e baixe de novo.
-
03
Descompactar
unzip -o Yami-EDR-release.zip && rm Yami-EDR-release.zip*Só se o passo anterior deu OK.
-
04
Criar a pasta de dados
mkdir -p /opt/yamiedr/data -
05
Criar o primeiro admin
cd /opt/yamiedr && python3 server.py initPergunta usuário e senha. Use uma senha forte e única.
-
06
Instalar como serviço (sobe no boot)
cp systemd/yamiedr.service /etc/systemd/system/ systemctl daemon-reload && systemctl enable --now yamiedr -
07
Conferir
systemctl is-active yamiedrsaída esperada:
active
Via Docker
O banco fica no volume ./data, fora do container.
-
01
Baixar + conferir
curl -fsSLO https://yamiedr.com/downloads/Yami-EDR-release.zip curl -fsSLO https://yamiedr.com/downloads/Yami-EDR-release.zip.sha256 sha256sum -c Yami-EDR-release.zip.sha256saída esperada:
Yami-EDR-release.zip: OKPrecisa dizer OK antes de seguir.
-
02
Extrair
unzip -o Yami-EDR-release.zip && cd yamiedr -
03
Criar o primeiro admin (uma vez)
docker compose run --rm yami python3 server.py init -
04
Subir
docker compose up -d -
05
Conferir
docker compose psO serviço yami deve aparecer como running.
04 Primeiro acesso
Abra http://IP-DO-SERVIDOR:8787 e entre com o admin que você criou. Já está no plano Essencial grátis, pronto para monitorar.
Atenção Sem HTTPS, a senha trafega em texto puro. Até configurar o HTTPS (seção abaixo), acesse por um túnel SSH, a partir do seu computador:
ssh -L 8787:127.0.0.1:8787 usuario@IP-DO-SERVIDOR
Com o túnel aberto, use http://127.0.0.1:8787 no seu navegador.
05 Ativar licença (opcional)
Opcional. Só para subir de plano (Pro/Enterprise).
- 1Solicite a licença à D.O.G pela página de contato.
- 2No console: Operações de segurança → Licença.
- 3Cole a chave e clique em Salvar. O plano sobe na hora.
06 Primeiros passos
-
DIA_0 · 01
Criar o cliente
Clientes e acessos → criar o cliente/empresa (tenant).
-
DIA_0 · 02
Instalar agentes
Adicionar agente → copiar o comando → rodar nas máquinas → elas aparecem em Agentes.
-
DIA_0 · 03
Superfície de ataque (opcional)
Superfície → Ativos → cadastrar o domínio → o pipeline roda sozinho.
-
DIA_0 · 04
Notificações
Automação → Notificações → ligar um canal e preencher o plantão.
07 HTTPS
Recomendado assim que você tiver um domínio. Exemplo com Caddy, que emite e renova o certificado sozinho:
yami.yamiedr.com {
reverse_proxy 127.0.0.1:8787
}
Depois feche a porta 8787 para fora (firewall), deixando só 80/443 abertas.
ufw deny 8787/tcp
08 Atualizar
Via Zip
-
01
Parar o serviço e guardar uma cópia dos dados
systemctl stop yamiedr cp -a /opt/yamiedr/data /opt/yamiedr-data-$(date +%F) -
02
Baixar e conferir a nova versão
cd /opt curl -fsSLO https://yamiedr.com/downloads/Yami-EDR-release.zip curl -fsSLO https://yamiedr.com/downloads/Yami-EDR-release.zip.sha256 sha256sum -c Yami-EDR-release.zip.sha256 -
03
Extrair sem tocar nos dados e subir
unzip -o Yami-EDR-release.zip -x "yamiedr/data/*" && rm Yami-EDR-release.zip* systemctl start yamiedr
Via Docker
-
01
Parar e guardar uma cópia dos dados
docker compose down cp -a data ../yamiedr-data-$(date +%F) -
02
Baixar, conferir e extrair
cd .. curl -fsSLO https://yamiedr.com/downloads/Yami-EDR-release.zip curl -fsSLO https://yamiedr.com/downloads/Yami-EDR-release.zip.sha256 sha256sum -c Yami-EDR-release.zip.sha256 unzip -o Yami-EDR-release.zip -x "yamiedr/data/*" && cd yamiedr -
03
Subir de novo
docker compose up -d --buildO volume ./data preserva o banco.
09 Problemas comuns
-
DIAGNÓSTICO
Página não abre
Veja o estado e os logs do serviço.
systemctl status yamiedr docker compose logs yami -
DIAGNÓSTICO
Porta ocupada
Zip: mude o --port no ExecStart do yamiedr.service. Docker: mude o mapeamento "8787:8787" no docker-compose.yml.
-
CRÍTICO
Checksum falhou
NÃO instale. Apague o arquivo e baixe de novo. Se falhar outra vez, fale comigo.