Instalação

O TMAegis é um único binário estático escrito em Go. Não há nada para instalar nas máquinas que você verifica.

Baixar uma versão

Cada versão no GitHub tem um arquivo por plataforma, chamado tmaegis_<version>_<os>_<arch>: .zip para Windows e .tar.gz para Linux e macOS. Há também o checksums.txt com o SHA-256 de cada arquivo. A página Downloads mostra esses arquivos com seus hashes. O arquivo contém o binário tmaegis, as regras, os plugins e os arquivos de licença. Verifique o download antes de executá-lo.

sha256sum -c checksums.txt --ignore-missing
mkdir tmaegis && tar -xzf tmaegis_<version>_linux_amd64.tar.gz -C tmaegis && cd tmaegis
./tmaegis --help

Compilar do código-fonte

Você precisa de Git, Go 1.27 ou mais recente e make.

git clone https://github.com/tmaegis/tmaegis.git
cd tmaegis
make build
./bin/tmaegis --help

make build-all faz a compilação cruzada para Linux, Windows e macOS.

Conferir se funciona

tmaegis discover        # operating system and installed software
tmaegis rules export -o rules.json   # the full rule catalog as JSON

Painel auto-hospedado (opcional)

Reúna os resultados de vários hosts com o servidor incluído. As verificações enviam a ele o relatório JSON.

export TMAEGIS_SERVER_TOKEN=$(openssl rand -hex 24)
docker compose up -d
tmaegis scan --auto-detect --push-url http://localhost:8080

Configuração

As configurações ficam em config.yaml (veja config.example.yaml) e são carregadas automaticamente. Flags explícitas têm prioridade sobre o arquivo. Chaves úteis são os plugins habilitados, o provedor de IA e o idioma de exibição.

Execute as verificações como root sempre que puder. Muitas verificações leem arquivos ou configurações que só o root consegue ver, e uma verificação sem root as relata como reprovadas.