# Manuelle Installation

> Stellen Sie PentAGI manuell mit Docker Compose bereit – erstellen Sie das Arbeitsverzeichnis, füllen Sie die .env-Datei aus, fügen Sie einen LLM-Provider hinzu und starten Sie den Stack.

Verwenden Sie den manuellen Pfad, wenn Sie volle Kontrolle über die Konfiguration haben möchten oder den interaktiven Installer nicht ausführen können.

## [1. Arbeitsverzeichnis erstellen](https://pentagi.com/de/docs/getting-started/manual-installation/#1-create-a-working-directory)

```bash
mkdir -p ~/pentagi && cd ~/pentagi
```

## [2. Umgebungsdatei herunterladen](https://pentagi.com/de/docs/getting-started/manual-installation/#2-download-the-environment-file)

```bash
test -f .env || curl -fo .env.new https://raw.githubusercontent.com/vxcontrol/pentagi/main/.env.example
test -f .env.new && openssl rand -hex 32 | xargs -I VALUE sed -E -i.bak 's/^COOKIE_SIGNING_SALT=salt( .*)?$/COOKIE_SIGNING_SALT=VALUE/' .env.new
test -f .env.new && openssl rand -hex 16 | xargs -I VALUE sed -E -i.bak 's/^PENTAGI_POSTGRES_PASSWORD=postgres( .*)?$/PENTAGI_POSTGRES_PASSWORD=VALUE/' .env.new
test -f .env || mv .env.new .env
```

Die Compose-Datei bindet drei Provider-Konfigurationsdateien ein; erstellen Sie diese daher – leere Dateien sind ausreichend:

```bash
touch example.custom.provider.yml example.ollama.provider.yml example.bedrock.provider.yml
```

Wenn Sie einen benutzerdefinierten OpenAI-kompatiblen Endpunkt oder Ollama verwenden möchten, laden Sie stattdessen die Beispielkonfigurationen herunter und verweisen Sie in `.env` mit `LLM_SERVER_CONFIG_PATH` oder `OLLAMA_SERVER_CONFIG_PATH` auf `/opt/pentagi/conf/custom.provider.yml` oder `/opt/pentagi/conf/ollama.provider.yml`. Das benutzerdefinierte Beispiel nennt OpenAI-Modelle, darunter `o3-mini`, das OpenAI am 23. Oktober 2026 einstellt – setzen Sie die `model` jedes [Agent Type](https://pentagi.com/de/docs/glossary/#agent-type) auf eines, das Ihr Endpunkt bereitstellt:

```bash
curl -o example.custom.provider.yml https://raw.githubusercontent.com/vxcontrol/pentagi/main/examples/configs/custom-openai.provider.yml
curl -o example.ollama.provider.yml https://raw.githubusercontent.com/vxcontrol/pentagi/main/examples/configs/ollama-llama318b.provider.yml
```

## [3. Mindestens einen LLM-Provider hinzufügen](https://pentagi.com/de/docs/getting-started/manual-installation/#3-add-at-least-one-llm-provider)

Bearbeiten Sie `.env` und legen Sie den Schlüssel für mindestens einen [Provider](https://pentagi.com/de/docs/glossary/#provider) fest:

```bash
OPEN_AI_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key
```

Weitere Providers – AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI und benutzerdefinierte Endpunkte – werden unter [LLM-Providers](https://pentagi.com/de/docs/configuration/llm-providers/) beschrieben. [Search Engines](https://pentagi.com/de/docs/glossary/#search-engine) sind optional; DuckDuckGo und Sploitus benötigen keinen Schlüssel:

```bash
DUCKDUCKGO_ENABLED=true
SPLOITUS_ENABLED=true
TAVILY_API_KEY=your_tavily_key
```

## [4. Stack starten](https://pentagi.com/de/docs/getting-started/manual-installation/#4-start-the-stack)

```bash
curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/main/docker-compose.yml
test -f .env && docker compose up -d
```

Die Web-Benutzeroberfläche ist unter `https://localhost:8443` erreichbar. Melden Sie sich mit `admin@pentagi.com` / `admin` an und ändern Sie das Passwort.

Die Web-UI und die anderen Dienste sind an localhost gebunden, aber die [Sandbox](https://pentagi.com/de/docs/glossary/#sandbox) jedes [Flow](https://pentagi.com/de/docs/glossary/#flow) veröffentlicht zwei Callback-Ports, standardmäßig von `28000`–`29999`, auf jeder Schnittstelle des Docker-Hosts, und ufw filtert diese nicht. Schränken Sie diesen Bereich zuerst ein, wenn andere auf den Host zugreifen können – siehe [Netzwerkexposition](https://pentagi.com/de/docs/configuration/security/#network-exposure). Um die Installation später zu aktualisieren, folgen Sie der Anleitung unter [Aktualisierung](https://pentagi.com/de/docs/deployment/upgrade/).

## [Optionale Stacks](https://pentagi.com/de/docs/getting-started/manual-installation/#optional-stacks)

Jeder optionale Dienst wird als eigene Compose-Datei bereitgestellt, die Sie zusätzlich zur Basisdatei einbinden:

| Stack                                              | Compose-Datei                                                                                      | Funktion                                              |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| LLM-Observierbarkeit                               | [`docker-compose-langfuse.yml`](https://pentagi.com/de/docs/configuration/observability/#langfuse)                       | Langfuse mit ClickHouse, Redis und MinIO              |
| [Knowledge Graph](https://pentagi.com/de/docs/glossary/#knowledge-graph) | [`docker-compose-graphiti.yml`](https://pentagi.com/de/docs/concepts/memory/#knowledge-graph-optional)                   | Graphiti und Neo4j                                    |
| System-Observierbarkeit                            | [`docker-compose-observability.yml`](https://pentagi.com/de/docs/configuration/observability/#grafana-and-opentelemetry) | Grafana, OpenTelemetry, VictoriaMetrics, Jaeger, Loki |

> [!WARNING]
> Für Produktionsumgebungen und alle Umgebungen, in denen nicht vertrauenswürdiger Code ausgeführt wird, isolieren Sie die Tool-Container auf einem dedizierten [Worker Node](https://pentagi.com/de/docs/deployment/worker-node/).