# Hızlı başlangıç

> PentAGI'yi etkileşimli yükleyici ile kurun — sistem gereksinimleri, indirme, providers ve search engines için rehberli kurulum ve ilk oturum açma.

## [Sistem gereksinimleri](https://pentagi.com/tr/docs/getting-started/quickstart/#system-requirements)

* Docker Compose ile Docker Engine 20 veya üzeri; [Podman](https://pentagi.com/tr/docs/deployment/production/#podman) üzerinde [elle kurulum yapın](https://pentagi.com/tr/docs/getting-started/manual-installation/)
* En az 2 vCPU ve 4 GB RAM
* 25 GB boş disk alanı
* İmajlar ve güncellemeler için internet erişimi

## [Kurulum programını indirin](https://pentagi.com/tr/docs/getting-started/quickstart/#download-the-installer)

Kurulum programı, sisteminizi denetleyen, [providers](https://pentagi.com/tr/docs/glossary/#provider)'ı ve [search engines](https://pentagi.com/tr/docs/glossary/#search-engine)'i yapılandıran, kurulumu güçlendiren ve yığını dağıtan bir terminal kullanıcı arayüzüdür.

| Platform            | Arşiv                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------- |
| Linux amd64         | [installer-latest.zip](https://pentagi.com/downloads/linux/amd64/installer-latest.zip)   |
| Linux arm64         | [installer-latest.zip](https://pentagi.com/downloads/linux/arm64/installer-latest.zip)   |
| Windows amd64       | [installer-latest.zip](https://pentagi.com/downloads/windows/amd64/installer-latest.zip) |
| macOS Intel         | [installer-latest.zip](https://pentagi.com/downloads/darwin/amd64/installer-latest.zip)  |
| macOS Apple silicon | [installer-latest.zip](https://pentagi.com/downloads/darwin/arm64/installer-latest.zip)  |

> [!WARNING]
> macOS yapıları imzalanmış ve onaylanmıştır. macOS kurulum programını yine de engellerse, uyarıyı geçersiz kılmayın: CPU'nuz için arşivi yukarıdaki bağlantılardan tekrar indirin.

## [Önce izleyin](https://pentagi.com/tr/docs/getting-started/quickstart/#watch-it-first)

Kurulum programının çalışmasını gösteren bir terminal kaydı [asciinema](https://asciinema.org/a/BHI8GnwhzOnH1EfsQCNRfBatu) üzerinde mevcuttur.

## [Çalıştırma](https://pentagi.com/tr/docs/getting-started/quickstart/#run-it)

```bash
mkdir -p ~/pentagi && cd ~/pentagi
uname -sm | sed -e 's,Linux ,linux/,' -e 's,Darwin ,darwin/,' -e s/x86_64/amd64/ -e s/aarch64/arm64/ | xargs -I PLATFORM curl -fLo installer.zip https://pentagi.com/downloads/PLATFORM/installer-latest.zip
unzip -o installer.zip
sudo ./installer
```

Kurulum programı Docker API'si ile `/var/run/docker.sock` üzerinden haberleşir; bu nedenle root yetkisi veya `docker` grubuna üye bir kullanıcı gerektirir:

```bash
sudo usermod -aG docker $USER
newgrp docker
docker ps
```

> [!NOTE]
> `docker` grubuna üyelik root yetkisine denktir. Bu yetkiyi yalnızca güvenilir kullanıcılara verin; üretim ortamlarında kurulum programını `sudo` ile çalıştırın veya rootsuz Docker kullanın.

Kurulum programı şu adımları gerçekleştirir:

1. **Sistem kontrolleri** — Docker, ağ bağlantısı ve gereksinimler.
2. **Ortam kurulumu** — makul varsayılan değerlere sahip bir `.env` dosyası.
3. **LLM providers** — OpenAI, Anthropic, Gemini, Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI veya özel bir uç nokta.
4. **Search engines** — DuckDuckGo, Google, Tavily, Firecrawl, Traversaal, Perplexity, Sploitus, SearXNG.
5. **Güvenlik güçlendirme** — üretilen kimlik bilgileri ve SSL sertifikaları.
6. **Dağıtım** — yığını Docker Compose ile başlatır.

## [Oturum açma](https://pentagi.com/tr/docs/getting-started/quickstart/#sign-in)

`https://localhost:8443` adresini açın ve varsayılan `admin@pentagi.com` / `admin` hesabıyla oturum açın, ardından 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). Ardından [ilk flow'unuz](https://pentagi.com/tr/docs/getting-started/first-flow/) ile devam edin; kurulumu daha sonra güncellemek için [Yükseltme](https://pentagi.com/tr/docs/deployment/upgrade/) bölümünü izleyin.