Self-Hosted KI-Agent-Sandboxes: p9m (p7y) & Mastra Factory
KI-Coding-Agenten sauber isolieren: Purgatorium (p9m, früher p7y) gibt jedem Agenten eigenen Docker-Daemon & URL, Mastra Factory macht aus Issues PRs.
6 Min. Lesezeit

Einen Coding-Agenten lokal am Laptop laufen zu lassen klappt gut, bis du drei parallel startest. Einer blockiert Port 3000 für den nächsten, der dritte führt docker compose down -v auf der falschen Datenbank aus, und plötzlich wartest du Umgebungen statt Code zu prüfen.
Zwei Open-Source-Projekte lösen unterschiedliche Hälften dieses Problems auf eigener Hardware: Purgatorium (p9m, früher p7y) stellt jedem Entwickler und KI-Agenten eine isolierte Docker-in-Docker-Sandbox mit eigener URL und automatischem Schlafmodus bereit, während Mastra Factory (mastra-ai/template-factory) GitHub-, Linear-, Jira- und Slack-Aufgaben in geplante, umgesetzte und geprüfte Pull Requests überführt.
Zwei getrennte Ebenen im Self-Hosted-Agent-Stack
„Agent-Sandboxes“ und „Agent-Factories“ werden oft in einen Topf geworfen, erledigen aber verschiedene Jobs:
| Baustein | Purgatorium (p9m, früher p7y) |
Mastra Factory |
|---|---|---|
| Repo & Lizenz | csakaszamok/p9m (AGPL-3.0) | mastra-ai/template-factory (Apache-2.0) |
| Hauptaufgabe | Flüchtige Docker-Sandbox pro Branch/Agent mit Live-Preview-URL | Issue-zu-PR-Software-Factory (Triage, Plan, Code, Review) |
| Isolation | Sysbox Rootless DinD oder Kata-MicroVMs pro Sandbox | Mastra-Plattform-Sandboxes oder LocalFactorySandbox |
| Leerlauf-Verhalten | Legt inaktive Sandboxes via Sablier schlafen, weckt unter 10s auf | Dauerhafter Node.js-Server + PostgreSQL (pgvector) |
| Agent-Anbindung | HTTP-API, MCP-Server, offizielles Claude-Code-Plugin (p9m-team/p9m) |
Mastra-Agenten + GitHub-/Linear-/Jira-/Slack-Trigger |
| Bester Einsatz | Claude Code / Codex ganze Compose-Stacks mit Preview-Links testen lassen | Backlog-Tickets oder Slack-@Mentions automatisch in PRs verwandeln |
Hinweis zur Umbenennung p7y -> p9m
Falls dir das Repo auf GitHub Trending als p7y-dev/p7y begegnet ist: Es liegt jetzt unter csakaszamok/p9m (Purgatorium) mit automatischer Weiterleitung. Das offizielle Docker-Image ist ghcr.io/csakaszamok/p9m:0.21.1 (Pre-1.0 mit aktivem Changelog und möglichen Breaking Changes zwischen Minor-Versionen).
Teil 1: Purgatorium (p9m), ein Docker-Daemon und eine URL pro Agent
Einfache Container-Setups (wie unser sicherer Docker-Container für KI-CLIs, auf Englisch) isolieren nur eine Shell und scheitern, sobald ein Agent docker compose up samt Postgres und Redis starten will. /var/run/docker.sock direkt hineinzureichen öffnet dem Container Root-Rechte auf dem Host.
Purgatorium legt Sysbox (oder Kata Containers-MicroVMs) unter jede Sandbox. Jede Instanz erhält einen eigenen Docker-Daemon, eine eigene https://<name>.<deine-domain>-Adresse über Traefik, TLS-TCP-Endpunkte für Postgres/Redis/SSH sowie Sablier, das ungenutzte Sandboxes schlafen legt und beim nächsten HTTP-Aufruf in unter 10 Sekunden weckt.
Dazu kommen eine eingebaute Registry mit Secret-Scanning, auf einzelne Sandboxes begrenzte Tokens, ein MCP-Server (JSON-RPC über HTTP) und ein Claude-Code-Plugin.
p9m lokal testen vs. auf einem Linux-VPS betreiben
Lokal testen (lvh.me)
Mit Docker Engine (oder Docker Desktop) und freien Ports 80/443:
mkdir p9m && cd p9m
curl -fsSLO https://github.com/csakaszamok/p9m/releases/latest/download/docker-compose.yml
curl -fsSL https://github.com/csakaszamok/p9m/releases/latest/download/setup.sh | bash
docker compose up -dsetup.sh erzeugt Zufalls-Secrets in .env und gibt das Admin-Passwort aus. Öffne http://p9m.lvh.me (lvh.me löst alle Subdomains auf 127.0.0.1 auf) und klicke auf New sandbox. Die erste Sandbox lädt Basis-Images herunter, jede weitere startet in etwa 10 Sekunden.
Produktiv auf Linux-VPS (Sysbox)
Auf einem Linux-VPS installierst du zuerst Sysbox, damit ALLOWED_RUNTIMES=sysbox ohne privilegiertes dind greift. Prüfe zuerst den Host:
curl -fsSL https://github.com/csakaszamok/p9m/releases/latest/download/check-host.sh | bash -s -- dev.example.comDanach mit deiner Wildcard-Domain (*.dev.example.com auf den VPS) einrichten:
mkdir p9m && cd p9m
curl -fsSLO https://github.com/csakaszamok/p9m/releases/latest/download/docker-compose.yml
curl -fsSL https://github.com/csakaszamok/p9m/releases/latest/download/setup.sh | bash -s -- dev.example.com
docker compose up -d
# Host-Check wiederholen, um offene Sicherheitslücken zu finden
curl -fsSL https://github.com/csakaszamok/p9m/releases/latest/download/check-host.sh | bashIn Claude Code bindest du das Plugin über den offiziellen Marketplace-Namen (p9m-team/p9m) ein:
/plugin marketplace add p9m-team/p9m
/p9m:init https://sbx.dev.example.comWichtige Sicherheitsregel aus der docker-compose.yml von p9m: Belasse ALLOWED_RUNTIMES=sysbox (oder sysbox,kata bei Nested-Virt/Bare-Metal). Aktiviere niemals privilegiertes dind auf einem geteilten Server.
Teil 2: Mastra Factory, Self-Hosted-Kanban vom Issue bis zum PR
Das Team hinter dem TypeScript-Framework Mastra (siehe KI-Agent mit Mastra bauen, auf Englisch) hat das interne System veröffentlicht, mit dem es in einer Woche 238 Agent-PRs neben 630 menschlichen PRs gemergt hat.
Mastra Factory ist ein dauerhafter Server (Web-UI + API) auf Basis von PostgreSQL mit pgvector und Anbindung an GitHub, Linear, Jira und Slack. Issues landen in Work -> Intake (oder per @-Erwähnung in Slack), werden analysiert, als Plan zur Freigabe vorgelegt, in einer Sandbox umgesetzt und als Pull Request samt automatischer Review-Antworten geöffnet.
Mastra Factory komplett selbst hosten (ohne Mastra Cloud)
Ohne Flag verbindet npm create factory gegen Mastra Cloud. Mit --no-platform entsteht das selbst gehostete Template (getrennt vom Ziel-Repository anlegen):
npm create factory -- --no-platform
cd my-factoryVerschlüsselungsschlüssel für gespeicherte API-Keys erzeugen und sicher sichern:
openssl rand -base64 32Mindest-Einträge in .env:
DATABASE_URL=postgresql://user:[email protected]:5432/factory
FACTORY_CREDENTIAL_ENCRYPTION_KEY=erzeugter-32-byte-base64-key
MASTRACODE_PUBLIC_URL=https://factory.example.comDATABASE_URL verlangt PostgreSQL mit pgvector (Hinweise zu aktuellen Postgres-Docker-Stacks findest du im PostgreSQL 19 Guide und im pgvector-Docker-Guide, auf Englisch). Für lokale Sandbox-Ausführung übergibst du new LocalFactorySandbox() aus @mastra/factory an MastraFactory in src/mastra/index.ts. Bei Slack-Nutzung müssen alle vier Slack-Variablen gesetzt sein, sonst bricht der Start bewusst ab.
Danach bauen und starten:
npm install
npm run build
npm run startVerbinde im Web-UI unter Settings -> Work Intake -> GitHub issues deine GitHub App, hinterlege ein Modell und teste den ersten Lauf an einem kleinen Doku- oder Test-Ticket.
Leitplanken vor dem Live-Betrieb
- CPU, RAM und Quotas begrenzen. Passe in
p9mSANDBOX_CPUS(2),SANDBOX_MEMORY(4g),SANDBOX_DISK(20g) undSANDBOX_QUOTA(3 pro Nutzer) an, damit kein Build-Loop den VPS lahmlegt. - Nur mit Sysbox oder Kata produktiv betreiben. Privilegiertes DinD gehört nur auf Wegwerf-Testmaschinen.
- Menschliche Merge-Freigabe behalten. Lass Agenten implementieren, testen und Lint beheben, aber halte Branch Protection und CI-Checks aktiv.
- Ports absichern und OIDC einschränken. Terminiere TLS über Traefik oder Caddy, setze
OIDC_ALLOWED_EMAILSund beachte, dass Docker UFW umgeht (auf Englisch). - Encryption Key und Postgres sichern. Ohne
FACTORY_CREDENTIAL_ENCRYPTION_KEYsind alle gespeicherten Provider-Keys verloren.
Wann welches Tool passt
Wenn du weiter direkt in Claude Code, OpenCode oder Codex arbeitest und schlicht eine saubere Self-Hosted-Plattform für Compose-Sandboxes samt Preview-URLs willst, löst Purgatorium (p9m) genau dieses Problem.
Wenn ein Team-Repo laufend kleine Bugfixes und Tickets aus GitHub oder Slack abarbeiten soll, ist Mastra Factory der stärkere Einstieg, besonders in TypeScript- und PostgreSQL-Stacks.
Häufige Fragen (FAQ)
Warum leitet p7y auf GitHub zu p9m weiter?
Das Projekt wurde von p7y in Purgatorium (p9m) unter github.com/csakaszamok/p9m umbenannt. Die alte Adresse leitet weiter; der Claude-Code-Plugin-Marketplace heißt p9m-team/p9m.
Läuft Mastra Factory komplett ohne Mastra Cloud?
Ja. Mit npm create factory -- --no-platform, einer eigenen PostgreSQL-Instanz mit pgvector und LocalFactorySandbox betreibst du es vollständig auf eigener Hardware hinter HTTPS.
Wie viel RAM braucht ein VPS für p9m?
Plane mindestens 8–16 GB RAM auf einem Linux-VPS ein. Jede aktive Sandbox darf standardmäßig bis zu 4 GB belegen (SANDBOX_MEMORY=4g); da Sablier inaktive Sandboxes schlafen legt, reichen 16 GB bequem für mehrere parallele Branches.
Hat diese Anleitung bei dir funktioniert?
Brauchst du Hilfe bei Astro, VPS oder einer Self-hosted-App? Services ansehen →


