Blog · Anleitung · 28. Oktober 2026
AEGIS selbst hosten mit Firecracker: was die Doku beschreibt und was heute läuft
Offenlegung: 100monkeys.ai entwickelt AEGIS, lesen Sie diese Anleitung also als Bericht des Herstellers. Einer unserer KI-Agenten hat sie aus der öffentlichen AEGIS-Dokumentation entworfen, vor allem Firecracker Deployment, What are Agents?, Infrastructure Requirements und Podman Deployment, und das Unternehmen hat sie geprüft; diese deutsche Ausgabe ist eine Übersetzung der englischen Originalanleitung. Jeder Befehl und jeder Konfigurationsblock ist aus diesen Seiten kopiert. Für diese Anleitung haben wir keinen davon ausgeführt.
AEGIS by 100monkeys.ai, in beta, ist ein selbst gehosteter Orchestrator für autonome Agenten. Die Doku beschreibt Firecracker-MicroVMs als Isolation für gehärtete Produktion. Lesen Sie die erste Zeile dieser Seite, bevor Sie Hardware kaufen: "Firecracker support is planned for a future release and is not yet available. The Docker and Podman runtimes are the current deployment targets." (Firecracker-Unterstützung ist für ein künftiges Release geplant und noch nicht verfügbar. Die Laufzeiten Docker und Podman sind die aktuellen Deployment-Ziele.) Diese Anleitung behandelt, was Sie heute tun können: einen Host prüfen, die für die geplante Laufzeit dokumentierte Konfiguration lesen und den Podman-Weg nutzen, der schon ausgeliefert ist.
Warum Firecracker, in den Worten der Doku
"Docker containers share the host kernel: a container escape vulnerability could give a malicious prompt-injected agent code execution on the host. Firecracker provides hardware-level isolation via KVM." (Docker-Container teilen sich den Host-Kernel: Eine Container-Escape-Lücke könnte einem per Prompt Injection manipulierten Agenten Codeausführung auf dem Host verschaffen. Firecracker bietet Isolation auf Hardwareebene über KVM.) Der Vergleich der Seite gibt jedem Agenten "a dedicated guest kernel per agent" (einen eigenen Gast-Kernel pro Agent), einen Schadensradius bei einem Ausbruch "bounded to single microVM" (begrenzt auf eine einzige MicroVM) und Speicher über virtio-fs, "shared memory, no network" (gemeinsamer Speicher, kein Netzwerk), wo Container NFS nutzen. Der genannte Preis ist ein Start in etwa 125 ms gegenüber etwa 100 ms bei einem Container.
Das Design lässt Agenten über Laufzeiten hinweg unverändert: "Switching a node from Docker to Podman or Firecracker requires only a config change: no agent manifest changes needed." (Einen Knoten von Docker auf Podman oder Firecracker umzustellen, erfordert nur eine Konfigurationsänderung: keine Änderungen an Agenten-Manifesten.) Deshalb ist Vorbereitung jetzt keine verlorene Arbeit.
Schritt 1. Den Host auf KVM prüfen
Firecracker braucht KVM, laut Doku also "bare-metal Linux servers with Intel VT-x or AMD-V CPU virtualization extensions" (Bare-Metal-Linux-Server mit den Virtualisierungserweiterungen Intel VT-x oder AMD-V), oder Cloud-Instanzen, die Bare Metal sind oder verschachtelte Virtualisierung bieten. Nicht unterstützt: "NOT supported on standard EC2 instances without bare-metal, most VMs (including standard VMs on most cloud providers), and macOS (Docker Desktop)." (NICHT unterstützt auf Standard-EC2-Instanzen ohne Bare Metal, den meisten VMs, auch Standard-VMs der meisten Cloud-Anbieter, und macOS mit Docker Desktop.) Die Prüfungen der Doku, kopiert:
# Check for KVM device nodes
ls -la /dev/kvm
# Verify CPU virtualization extensions
grep -cw vmx /proc/cpuinfo # Intel (should return > 0)
grep -cw svm /proc/cpuinfo # AMD (should return > 0)Fehlt /dev/kvm auf einer Cloud-VM, wird dieser Host die Firecracker-Laufzeit nicht ausführen, wenn sie erscheint, ganz gleich, was er sonst mitbringt.
Schritt 2. Den Kernel prüfen
Führen Sie uname -r aus und vergleichen Sie mit der Doku. Zwei Seiten nennen zwei Mindestversionen: What are Agents? nennt "Bare-metal or KVM-passthrough host, Linux kernel 5.10+" (Bare-Metal- oder KVM-Passthrough-Host, Linux-Kernel 5.10 oder neuer), und Infrastructure Requirements nennt "Linux kernel 5.15+" mit "KVM support for Firecracker (planned later phase)" (KVM-Unterstützung für Firecracker, für eine spätere Phase geplant). Planen Sie 5.15 oder neuer ein, dann erfüllen Sie beide.
Schritt 3. Die dokumentierte Konfiguration lesen
Die geplante Laufzeit wird in aegis-config.yaml unter runtime.firecracker konfiguriert. Der Block der Seite, kopiert:
runtime:
type: firecracker
firecracker:
# Path to the jailer binary
jailer_binary: /usr/local/bin/jailer
# Path to the Firecracker VMM binary
firecracker_binary: /usr/local/bin/firecracker
# User/group for the jailed process
uid: 65534 # nobody
gid: 65534
# Kernel image for microVMs
kernel_image_path: /opt/aegis/vmlinux
# Root filesystem for agent microVMs (minimal Linux + Python)
rootfs_path: /opt/aegis/agent-rootfs.ext4
# CPU and memory limits
vcpu_count: 2
mem_size_mib: 512
# cgroup version (v1 or v2)
cgroup_version: v2Lesen Sie ihn daraufhin, was er vom Host verlangt: einen Jailer und ein Firecracker-Binary, eine unprivilegierte uid und gid, ein Gast-Kernel-Image, ein Root-Dateisystem für den Agenten sowie CPU und Speicher pro VM. Der Jailer "drops privileges before starting the VMM" (gibt Privilegien ab, bevor er den VMM startet): ein chroot-Gefängnis, ein vorab angelegtes Tap-Interface und eine Cgroup sowie seccomp-Filter. Jede MicroVM erhält ein eigenes Tap-Gerät, und "outbound traffic from the microVM is routed through the orchestrator proxy (SEAL), not directly to the internet." (ausgehender Verkehr der MicroVM läuft über den Proxy des Orchestrators, SEAL, nicht direkt ins Internet.)
Setzen Sie diesen Block heute nicht ein. Die Doku sagt nicht, woher Kernel-Image und Root-Dateisystem kommen, und die Laufzeit, die sie liest, wird als "in development" (in Entwicklung) beschrieben.
Schritt 4. AEGIS heute auf Podman betreiben
Für die Produktion heute verweist die Doku auf das Repository aegis-deploy: "aegis-deploy is the recommended production deployment path. It includes OpenBao (secrets management), TLS via Caddy, and full observability." (aegis-deploy ist der empfohlene Weg für Produktions-Deployments. Er umfasst OpenBao für die Verwaltung von Geheimnissen, TLS über Caddy und vollständige Beobachtbarkeit.) Sein Schnellstart, kopiert:
# Clone the deployment repo
git clone https://github.com/100monkeys-ai/aegis-deploy.git
cd aegis-deploy
# Copy and edit environment configuration
cp .env.example .env
# Edit .env with your values (GHCR credentials, passwords, LLM API keys)
# Install system dependencies (Ubuntu)
make setup
# Authenticate with GitHub Container Registry
make registry-login
# Generate SEAL signing keys
make generate-keys
# Deploy the full stack
make deploy PROFILE=full
# Validate all services are healthy
make validate
# Bootstrap secrets
make bootstrap-secretsPodman führt Agenten ohne Root aus; die Doku schreibt dem zu, dass "the privileged daemon" (der privilegierte Daemon) entfällt und Container-Root "to an unprivileged host UID" (auf eine unprivilegierte Host-UID) abgebildet wird. Zur Evaluierung auf einem Rechner ist der Einzeiler auf 100monkeys.ai curl -fsSL https://get.100monkeys.ai | bash; er startet den lokalen Docker-Stack, den die Doku als "for local testing and evaluation only" (nur für lokale Tests und Evaluierung) kennzeichnet.
Schritt 5. Den Wechsel als Konfigurationsänderung halten
Schreiben Sie Agenten-Manifeste, ohne die Isolation festzulegen, damit der Knoten entscheidet. Das Manifestfeld isolation akzeptiert inherit, firecracker, docker und process; sein Standard ist inherit, "from node config" (aus der Knotenkonfiguration). Das Beispiel der Konfigurationsreferenz setzt default_isolation des Knotens auf docker, einen Wert, der "works with both Docker and Podman runtimes" (mit den Laufzeiten Docker und Podman funktioniert). Wenn Firecracker erscheint, ändert sich der Knoten, nicht jeder Agent.
Schritt 6. Die Arbeit verfolgen
Die Seite endet mit: "Monitor progress on Firecracker support in the aegis-orchestrator GitHub repository." (Verfolgen Sie den Fortschritt der Firecracker-Unterstützung im GitHub-Repository aegis-orchestrator.) Dort wird ein Release genannt werden, das die Laufzeit ausliefert.
Was die Doku offenlässt
- Ein Datum oder eine Version für die Firecracker-Unterstützung.
- Woher der Gast-Kernel (
vmlinux) und das Root-Dateisystem des Agenten kommen und wie man sie baut. - Den Mindest-Kernel: 5.10 auf einer Seite, 5.15 auf einer anderen.
- Andere Seiten beschreiben Firecracker noch als gehärtete Produktionslaufzeit ohne den Hinweis "not yet available" (noch nicht verfügbar); nehmen Sie daher die Firecracker-Seite selbst als aktuellen Stand.
Weiter
Um den Evaluierungs-Stack zu installieren und einen ersten Agenten hinter einer Freigabe auszuführen, lesen Sie AEGIS auf einem frischen Ubuntu-VPS installieren und die erste freigegebene Aufgabe ausführen.