# Manuel kurulum

> PentAGI'yi Docker Compose ile manuel olarak dağıtın — çalışma dizinini oluşturun, .env dosyasını doldurun, bir LLM provider ekleyin ve yığını başlatın.

Yapılandırma üzerinde tam kontrol sağlamak istediğinizde veya etkileşimli kurulum programını çalıştıramadığınızda manuel yolu kullanın.

## [1. Çalışma dizini oluşturun](https://pentagi.com/tr/docs/getting-started/manual-installation/#1-create-a-working-directory)

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

## [2. Ortam dosyasını indirin](https://pentagi.com/tr/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
```

Compose dosyası üç [provider](https://pentagi.com/tr/docs/glossary/#provider) yapılandırma dosyasını bağlar; bu nedenle bunları oluşturun — boş dosyalar yeterlidir:

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

Özel bir OpenAI uyumlu uç nokta veya Ollama kullanmayı planlıyorsanız, boş dosyalar yerine örnek yapılandırmaları indirin ve `.env` içindeki `LLM_SERVER_CONFIG_PATH` veya `OLLAMA_SERVER_CONFIG_PATH` değerlerini `/opt/pentagi/conf/custom.provider.yml` veya `/opt/pentagi/conf/ollama.provider.yml` olarak ayarlayın. Özel örnek, aralarında 23 Ekim 2026 tarihinde OpenAI tarafından emekliye ayrılacak olan `o3-mini`'in de bulunduğu OpenAI modellerini adlandırır; her [agent](https://pentagi.com/tr/docs/glossary/#agent)'in `model` değerini uç noktanızın sunduğu bir model olarak ayarlayın:

```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. En az bir LLM provider ekleyin](https://pentagi.com/tr/docs/getting-started/manual-installation/#3-add-at-least-one-llm-provider)

`.env` dosyasını düzenleyin ve en az bir provider için anahtarı ayarlayın:

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

AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI ve özel uç noktalar gibi diğer providers [LLM providers](https://pentagi.com/tr/docs/configuration/llm-providers/) bölümünde açıklanmıştır. [Search engines](https://pentagi.com/tr/docs/glossary/#search-engine) isteğe bağlıdır; DuckDuckGo ve Sploitus için anahtar gerekmez:

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

## [4. Yığını başlatın](https://pentagi.com/tr/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
```

Web arayüzü `https://localhost:8443` adresinde sunulur. `admin@pentagi.com` / `admin` ile oturum açın ve parolayı değiştirin.

Web kullanıcı arayüzü ve diğer hizmetler localhost ile sınırlıdır, ancak her [flow](https://pentagi.com/tr/docs/glossary/#flow)'un [sandbox](https://pentagi.com/tr/docs/glossary/#sandbox)'ı, varsayılan olarak `28000`–`29999` aralığında iki geri çağırma bağlantı noktasını Docker ana bilgisayarının tüm arayüzlerinde yayımlar ve ufw bunları filtrelemez. Başkalarının erişebileceği bir ana bilgisayarda, önce bu aralığı kısıtlayın — bkz. [Ağ maruziyeti](https://pentagi.com/tr/docs/configuration/security/#network-exposure). Kurulumu daha sonra güncellemek için [Yükseltme](https://pentagi.com/tr/docs/deployment/upgrade/) bölümünü izleyin.

## [İsteğe bağlı yığınlar](https://pentagi.com/tr/docs/getting-started/manual-installation/#optional-stacks)

Her isteğe bağlı hizmet, temel yığının üzerine katmanlayabileceğiniz kendi compose dosyasıyla birlikte gelir:

| Yığın                                              | Compose dosyası                                                                                    | Ekledikleri                                           |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| LLM gözlemlenebilirliği                            | [`docker-compose-langfuse.yml`](https://pentagi.com/tr/docs/configuration/observability/#langfuse)                       | ClickHouse, Redis ve MinIO ile Langfuse               |
| [Knowledge graph](https://pentagi.com/tr/docs/glossary/#knowledge-graph) | [`docker-compose-graphiti.yml`](https://pentagi.com/tr/docs/concepts/memory/#knowledge-graph-optional)                   | Graphiti ve Neo4j                                     |
| Sistem gözlemlenebilirliği                         | [`docker-compose-observability.yml`](https://pentagi.com/tr/docs/configuration/observability/#grafana-and-opentelemetry) | Grafana, OpenTelemetry, VictoriaMetrics, Jaeger, Loki |

> [!WARNING]
> Üretim ortamları ve güvenilmeyen kodların çalıştığı tüm ortamlar için, [tool](https://pentagi.com/tr/docs/glossary/#tool) konteynerlerini ayrılmış bir [worker node'da](https://pentagi.com/tr/docs/deployment/worker-node/) izole edin.