Installation

TMAegis ist eine einzelne statische, in Go geschriebene Binärdatei. Auf den gescannten Rechnern muss nichts installiert werden.

Release herunterladen

Jedes GitHub-Release enthält pro Plattform ein Archiv mit dem Namen tmaegis_<version>_<os>_<arch>: .zip für Windows und .tar.gz für Linux und macOS. Dazu gibt es checksums.txt mit der SHA-256-Prüfsumme jedes Archivs. Die Seite Downloads zeigt diese Dateien mit ihren Hashes. Das Archiv enthält die Binärdatei tmaegis, die Regeln, die Plugins und die Lizenzdateien. Prüfen Sie den Download, bevor Sie ihn ausführen.

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

Aus Quellcode kompilieren

Sie benötigen Git, Go 1.27 oder neuer und make.

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

make build-all kompiliert für Linux, Windows und macOS.

Funktion prüfen

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

Selbst gehostetes Dashboard (optional)

Sammeln Sie die Ergebnisse vieler Hosts mit dem mitgelieferten Server. Scans senden ihren JSON-Bericht dorthin.

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

Konfiguration

Einstellungen stehen in config.yaml (siehe config.example.yaml) und werden automatisch geladen. Explizite Flags überschreiben die Datei. Nützliche Schlüssel sind die aktivierten Plugins, der KI-Anbieter und die Anzeigesprache.

Führen Sie Scans nach Möglichkeit als root aus. Viele Prüfungen lesen Dateien oder Einstellungen, die nur root sehen kann; ein Scan ohne root meldet diese als fehlgeschlagen.