aegisaur/INSTALL.md

📦 Installation Guide

⚡ Schnellstart (empfohlen)

# 1. Source Tarball herunterladen (enthält ALLE Dateien)
cd /tmp
wget https://gitea.die-heimatlosen.eu/arch_agent/aegisaur/archive/master.tar.gz

# 2. Entpacken
tar xzf master.tar.gz
cd aegisaur

# 3. Verifizieren (alle 7 Dateien müssen da sein)
ls src/
# → config.rs, hook.rs, ioc_fetcher.rs, main.rs, scanner.rs, trust_scorer.rs, utils.rs

# 4. Bauen und installieren
cargo build --release
sudo cp target/release/aegisaur /usr/local/bin/
sudo aegisaur install-hook

⚠️ WICHTIG: Git-Clone NICHT verwenden!

# ❌ NICHT SO - Fehlende Dateien!
git clone https://gitea.die-heimatlosen.eu/arch_agent/aegisaur.git

# Warum: Gitea API zeigt Dateien >10KB nicht korrekt an
# (ioc_fetcher.rs, scanner.rs, trust_scorer.rs fehlen)

Alternative: PKGBUILD

cd /tmp/aegisaur
makepkg -si

ALPM-Hook (systemweit)

# Installiert Hook nach /usr/share/libalpm/hooks/
sudo aegisaur install-hook

# Deinstalliert Hook
sudo aegisaur remove-hook

Konfiguration

# Erstellt ~/.config/aegisaur/config.toml
aegisaur config

Pfad-Übersicht

Komponente	Pfad
Binary (makepkg)	/usr/bin/aegisaur
Binary (manuell)	/usr/local/bin/aegisaur
ALPM-Hook	/usr/share/libalpm/hooks/99-aegisaur.hook
Hook-Script	/usr/share/libalpm/hooks/aegisaur-check.sh
Dokumentation	/usr/share/doc/aegisaur/
Config	~/.config/aegisaur/config.toml
Cache	~/.cache/aegisaur/
Quellcode	/home/arch_agent_system/.openclaw/workspace/aegisaur/
Gitea-Repo	https://gitea.die-heimatlosen.eu/arch_agent/aegisaur

Hook-Verhalten

Paket-Status	Aktion
IOCDetected	🚨 Alert, Installation abbrechen möglich
Dangerous	🚨 Alert, Installation abbrechen möglich
Suspicious	⚠️ Warnung wird angezeigt
Warning	⚠️ Warnung wird angezeigt
Safe	✅ Keine Meldung

---

Built with ❤️ (and some 👻 magic) Quasi & Thuumate — 2026