# Ruční instalace

> Nasaďte PentAGI ručně pomocí Docker Compose – vytvořte pracovní adresář, vyplňte soubor .env, přidejte LLM provider a spusťte stack.

Manuální postup použijte, pokud chcete mít plnou kontrolu nad konfigurací nebo nemůžete spustit interaktivní instalátor.

## [1. Vytvoření pracovního adresáře](https://pentagi.com/cs/docs/getting-started/manual-installation/#1-create-a-working-directory)

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

## [2. Stažení souboru prostředí](https://pentagi.com/cs/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
```

Soubor compose připojuje tři konfigurační soubory [provider](https://pentagi.com/cs/docs/glossary/#provider), proto je vytvořte — prázdné soubory postačí:

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

Pokud plánujete použít vlastní endpoint kompatibilní s OpenAI nebo Ollama, stáhněte si místo prázdných souborů ukázkové konfigurace a v `.env` nasměrujte `LLM_SERVER_CONFIG_PATH` nebo `OLLAMA_SERVER_CONFIG_PATH` na `/opt/pentagi/conf/custom.provider.yml` nebo `/opt/pentagi/conf/ollama.provider.yml`. Ukázková konfigurace pro vlastní nastavení uvádí modely OpenAI, mezi nimi `o3-mini`, který OpenAI vyřadí 23. října 2026 — nastavte `model` každého agenta na jeden z modelů, které váš endpoint poskytuje:

```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. Přidání alespoň jednoho LLM provider](https://pentagi.com/cs/docs/getting-started/manual-installation/#3-add-at-least-one-llm-provider)

Upravte `.env` a nastavte klíč alespoň jednoho provider:

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

Další providers — AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI a vlastní endpointy — jsou popsáni v sekci [LLM providers](https://pentagi.com/cs/docs/configuration/llm-providers/). [Search engines](https://pentagi.com/cs/docs/glossary/#search-engine) jsou volitelné; DuckDuckGo a Sploitus nevyžadují žádný klíč:

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

## [4. Spuštění služeb](https://pentagi.com/cs/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
```

Webové rozhraní je dostupné na adrese `https://localhost:8443`. Přihlaste se pomocí `admin@pentagi.com` / `admin` a změňte heslo.

Webové uživatelské rozhraní a ostatní služby jsou svázány s localhost, ale [sandbox](https://pentagi.com/cs/docs/glossary/#sandbox) každého [flow](https://pentagi.com/cs/docs/glossary/#flow) publikuje dva callback porty, ve výchozím nastavení z `28000`–`29999`, na všech rozhraních hostitele Dockeru a ufw je nefiltruje. Na hostiteli, který je dosažitelný pro ostatní, nejprve omezte tento rozsah – viz [Network exposure](https://pentagi.com/cs/docs/configuration/security/#network-exposure). Chcete-li instalaci později aktualizovat, postupujte podle [Upgrading](https://pentagi.com/cs/docs/deployment/upgrade/).

## [Volitelné služby](https://pentagi.com/cs/docs/getting-started/manual-installation/#optional-stacks)

Každá volitelná služba má vlastní soubor compose, který navrstvíte na ten základní:

| Služba                                             | Soubor compose                                                                                     | Co přidává                                            |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| Pozorovatelnost LLM                                | [`docker-compose-langfuse.yml`](https://pentagi.com/cs/docs/configuration/observability/#langfuse)                       | Langfuse s ClickHouse, Redis a MinIO                  |
| [Knowledge graph](https://pentagi.com/cs/docs/glossary/#knowledge-graph) | [`docker-compose-graphiti.yml`](https://pentagi.com/cs/docs/concepts/memory/#knowledge-graph-optional)                   | Graphiti a Neo4j                                      |
| Pozorovatelnost systému                            | [`docker-compose-observability.yml`](https://pentagi.com/cs/docs/configuration/observability/#grafana-and-opentelemetry) | Grafana, OpenTelemetry, VictoriaMetrics, Jaeger, Loki |

> [!WARNING]
> Pro produkční prostředí a jakékoli prostředí, kde běží nedůvěryhodný kód, izolujte kontejnery [tool](https://pentagi.com/cs/docs/glossary/#tool) na vyhrazeném [worker node](https://pentagi.com/cs/docs/deployment/worker-node/).