AutoGPT - Self-Hosting
Diese Seite fĂĽhrt dich durch den lokalen Betrieb der AutoGPT-Plattform mit Docker. Es gibt zwei Wege: einen One-Line-Installer, der alles fĂĽr dich erledigt, und ein manuelles Clone-and-Compose-Setup, das dir die volle Kontrolle gibt. Beide enden damit, dass der Agent Builder unter http://localhost:3000 erreichbar ist. Neu auf der Plattform? Lies zuerst die Ăśbersicht.
Die folgenden Schritte orientieren sich am offiziellen Self-Hosting-Guide unter agpt.co/docs/platform/self-hosting/getting-started und am Repository (autogpt_platform/docker-compose.yml, .env.default), geprüft am 25. Juni 2026. Self-Hosting ist ein wirklich technischer Prozess; wenn du lieber etwas Gemanagtes hättest, bietet AutoGPT auch eine cloud-gehostete Beta an (Warteliste).
1. Systemanforderungen​
Hardware​
| Ressource | Minimum | Empfohlen |
|---|---|---|
| CPU | 2 Kerne | 4+ Kerne |
| RAM | 8 GB | 16 GB |
| Speicher | 10 GB frei | mehr, die Docker-Images sind groĂź |
Der komplette Stack läuft mit ~15 Containern (Backend-Services + Supabase + Queue + Cache + Antivirus), daher ist eine 4-Kern-/16-GB-Maschine für komfortable lokale Entwicklung realistisch.
Software​
| Software | Mindestversion |
|---|---|
| Docker Engine | 20.10.0 |
| Docker Compose | 2.0.0 |
| Git | 2.30 |
| Node.js | 16.x |
| npm | 8.x |
| Editor | VSCode 1.60+ oder gleichwertig |
UnterstĂĽtzte Betriebssysteme: Linux (Ubuntu 20.04+), macOS (10.15+), Windows 10/11 mit WSL2.
PrĂĽfe deine Toolchain, bevor du startest:
node -v
npm -v
docker -v
docker compose -v
git --version
FĂĽhre unter Windows das gesamte Setup innerhalb einer WSL2-Distribution aus. Die Supabase-Container verhalten sich unter dem Hyper-V-Backend bekanntermaĂźen fehlerhaft. Installiere Docker Desktop mit aktiviertem WSL2-Backend und klone das Repo in dein Linux-Home-Verzeichnis, nicht in einen /mnt/c/...-Pfad.
2. Option A — One-Line-Installer (empfohlen)​
Der schnellste Weg. Das Skript installiert Abhängigkeiten, konfiguriert Docker und startet eine lokale Instanz.
macOS / Linux:
curl -fsSL https://setup.agpt.co/install.sh -o install.sh && bash install.sh
Windows (PowerShell):
powershell -c "iwr https://setup.agpt.co/install.bat -o install.bat; ./install.bat"
Wenn du ein entferntes Skript in eine Shell pipest, führst du aus, was diese URL ausliefert. Wenn du lieber zuerst sehen möchtest, was es tut, lade install.sh herunter und lies es, bevor du es ausführst — der obige Befehl speichert es bereits auf die Festplatte (-o install.sh), statt direkt nach bash zu pipen, sodass du die Datei einfach vor dem zweiten Schritt öffnen kannst.
Wenn es fertig ist, springe zu §5, um die App zu öffnen.
3. Option B — manuelles Setup​
Volle Kontrolle, und das, was du als Contributor im Alltag nutzen wirst.
1. Klone das Repository und wechsle in den Plattform-Ordner:
git clone https://github.com/Significant-Gravitas/AutoGPT.git
cd AutoGPT/autogpt_platform
2. Erstelle deine Environment-Datei aus der mitgelieferten Vorlage:
cp .env.default .env
Es gibt außerdem eine backend/.env.default; kopiere sie auf die gleiche Weise, wenn du Backend-Einstellungen ändern möchtest (siehe §4).
3. Baue und starte den gesamten Stack im Hintergrund:
docker compose up -d --build
Der erste Build zieht und baut viele Images und kann eine Weile dauern. Spätere Starts gehen schnell.
4. Folge den Logs (optional), um zu beobachten, wie die Services hochfahren:
docker compose logs -f
Makefile-Shortcuts​
Die Plattform liefert außerdem ein Makefile mit komfortablen Targets, die die Docker- und Dev-Server-Befehle kapseln. Gängige sind:
make start-core # die Core-Backend-Services starten
make run-backend # das Backend ausfĂĽhren
make run-frontend # den Frontend-Dev-Server ausfĂĽhren
Falls sich ein Target-Name geändert hat, führe make help aus (oder öffne das Makefile), um zu sehen, was in deinem Checkout verfügbar ist — die maßgeblichen Befehle sind immer die docker compose-Befehle oben.
4. Environment-Konfiguration​
Die .env-Datei, die du aus .env.default erstellt hast, enthält die Konfiguration für den Stack. Für einen schnellen lokalen Lauf funktionieren die Standardwerte unverändert. Zwei Dinge solltest du wissen:
- Encryption-Key — das Backend verwendet einen Encryption-Key (in der
backend-.env), um gespeicherte Credentials zu schützen. Der Standardwert ist für den temporären lokalen Gebrauch in Ordnung, aber ändere ihn, bevor du die Instanz für andere zugänglich machst. - Provider-Credentials — um Blocks zu nutzen, die externe Dienste aufrufen (OpenAI, Anthropic, GitHub, …), fügst du API-Keys entweder zur Laufzeit über die UI oder per Environment-Variablen hinzu. Du brauchst keinen davon, um die Plattform zu starten; du brauchst sie nur für die konkreten Blocks, die du ausführst.
.env.env enthält Secrets (Encryption-Keys, API-Keys). Sie ist standardmäßig git-ignored — lass das so. Füge keine echten Provider-Keys in Screenshots, Issues oder geteilte Logs ein.
5. Zugriff auf die Plattform​
Sobald die Container healthy sind, sind die Services unter diesen lokalen Ports erreichbar:
| Service | Port | URL |
|---|---|---|
| Frontend-UI (Agent Builder) | 3000 | http://localhost:3000 |
| Backend-WebSocket | 8001 | ws://localhost:8001 |
| Backend-REST-/Execution-API | 8006 | http://localhost:8006 |
Ă–ffne http://localhost:3000 in deinem Browser, erstelle ein lokales Konto, und du bist im Agent Builder.
3000 für das Frontend ist stabil und der Port, den du nutzen wirst. Die Backend-Port-Mappings sind in docker-compose.yml definiert (und in der Basis-Compose-Datei, die sie erweitert); wenn 8001/8006 nicht antworten, prüfe die tatsächlichen ports:-Mappings in deinem Checkout oder im offiziellen Getting-Started-Guide, da sie sich zwischen Releases ändern können.
6. Betrieb im Alltag​
# den Stack stoppen (Daten bleiben erhalten)
docker compose down
# stoppen und Volumes löschen (Neustart — löscht die lokale DB!)
docker compose down -v
# nach dem Pullen von neuem Code neu bauen
git pull
docker compose up -d --build
# prüfen, was läuft / unhealthy ist
docker compose ps
7. Troubleshooting​
| Symptom | Wahrscheinliche Ursache & Lösung |
|---|---|
localhost:3000 lädt nicht | Frontend-Container baut/startet noch. Prüfe docker compose ps und docker compose logs -f frontend. |
| Supabase-/Auth-/DB-Container crash-loopen unter Windows | Du bist auf dem Hyper-V-Backend. Stelle Docker Desktop auf WSL2 um und klone ins Linux-Dateisystem (§1). |
| Port bereits belegt | Ein anderer Prozess belegt 3000/8006/5432. Stoppe ihn oder ändere das host-seitige Port-Mapping in docker-compose.yml. |
| Build geht der Speicherplatz / Arbeitsspeicher aus | Schaffe Platz (die Images sind groß) und erhöhe die RAM-Zuweisung von Docker; der Stack will ~8 GB+. |
| Blocks, die externe APIs aufrufen, schlagen fehl | Fehlende/ungültige Provider-Credentials. Füge den API-Key für diesen Provider hinzu (§4). |
| Veralteter Zustand nach einem Upgrade | docker compose down -v, dann docker compose up -d --build für einen sauberen Neustart (das löscht lokale Daten). |
8. Nächste Schritte​
- Bau etwas: öffne den Agent Builder und verbinde ein paar Blocks zu einem Agenten.
- Erweitere die Plattform: Building Blocks zeigt, wie du einen eigenen Block zur Library hinzufĂĽgst.
- Hintergrund zur Architektur und zu den Konzepten: die Ăśbersicht.
9. Quellen​
- AutoGPT Self-Hosting-Guide — agpt.co/docs/platform/self-hosting/getting-started
- Significant-Gravitas/AutoGPT —
README.md,autogpt_platform/docker-compose.yml,autogpt_platform/.env.default(devbranch, geprĂĽft 2026-06-25)