> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Kurulum

> GOWA’yı Docker, Docker Compose, bir sürümün çalıştırılabilir dosyası veya kaynak kodla kurun ve bir ters vekilin arkasında çalıştırın.

![GOWA dağıtımı ve erişimine genel bakış](https://mintcdn.com/gowa-docs/xwa06XWUO2vnG9_f/images/GOWA-Deployment-and-Access-Overview.png?fit=max\&auto=format\&n=xwa06XWUO2vnG9_f\&q=85\&s=dc847e074e7578d3cfb8c83f1d756040)

GOWA tek bir çalıştırılabilir dosya olarak sunulur. REST API, webhook’lar, kontrol paneli ve MCP uç noktası, `whatsapp rest` ile birlikte başlar.

## Gereksinimler

| Öğe | Gerektiği kullanım |
| - | - |
| FFmpeg | Medya dönüştürme (video, sesli notlar). Docker imajına dahildir. |
| libwebp araçları (`cwebp`, `dwebp`, `webpmux`) | Animasyonlu WebP dahil çıkartmalar. Docker imajına dahildir. |
| Go 1.26+ | Yalnızca kaynak koddan derlemek için. |

Desteklenen platformlar: Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; WSL önerilir).

## Docker

İmajlar Docker Hub ve GHCR üzerinde yayımlanır:

* `aldinokemal2104/go-whatsapp-web-multidevice`
* `ghcr.io/aldinokemal/go-whatsapp-web-multidevice`

```bash theme={null}
docker volume create gowa_storages
docker volume create gowa_statics

docker run -d --name gowa --restart always \
  -p 3000:3000 \
  -v gowa_storages:/app/storages \
  -v gowa_statics:/app/statics \
  -e APP_BASIC_AUTH=admin:changeme \
  aldinokemal2104/go-whatsapp-web-multidevice:latest
```

* `/app/storages`, SQLite veritabanlarını (oturumlar, sohbet geçmişi, zamanlamalar, OAuth) barındırır. Kaybedilmesi tüm cihazların eşleştirmesini kaldırır.
* `/app/statics`, QR görsellerini, yüklemeleri ve indirilen medyayı barındırır.
* Varsayılan komut `rest` şeklindedir. Bayrakları bundan sonra iletin; örneğin `... go-whatsapp-web-multidevice rest --autoreply="Away"`.
* Giriş noktası, birim sahipliğini düzeltir ve yetkileri `gowauser` kullanıcısına düşürür (UID 20001, GID 20000).
* Konteyner saati UTC’dir (`TZ=UTC`). Günlüklerde yerel zaman damgaları gerekiyorsa `TZ` değerini değiştirin.

### Docker Compose

```yaml docker-compose.yml theme={null}
services:
  gowa:
    image: aldinokemal2104/go-whatsapp-web-multidevice:latest
    container_name: gowa
    restart: always
    ports:
      - "3000:3000"
    environment:
      APP_BASIC_AUTH: admin:changeme
      WHATSAPP_WEBHOOK: https://example.com/wa-hook
      WHATSAPP_WEBHOOK_SECRET: ${WHATSAPP_WEBHOOK_SECRET}
    volumes:
      - gowa_storages:/app/storages
      - gowa_statics:/app/statics

volumes:
  gowa_storages:
  gowa_statics:
```

`openssl rand -hex 32` ile kalıcı bir webhook anahtarı oluşturun ve `WHATSAPP_WEBHOOK_SECRET` değerini bu örneği başlatmadan önce kabuğunuzda veya Compose `.env` dosyasında ayarlayın.

Deponun kendi `docker-compose.yml` dosyası, imajı `docker/golang.Dockerfile` üzerinden derler ve `src/.env` dosyasını okur. Yerel olarak derlemek istediğinizde bunu kullanın: `cp src/.env.example src/.env && docker compose up -d --build`.

## Sürümün çalıştırılabilir dosyası

[GitHub Releases](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest) üzerinden bir arşiv indirin. Arşivler `whatsapp_<version>_<os>_<arch>.zip` biçiminde adlandırılır; örneğin:

```bash theme={null}
curl -fLO https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/download/v9.9.0/whatsapp_9.9.0_linux_amd64.zip
unzip whatsapp_9.9.0_linux_amd64.zip
chmod +x whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

Medya araçlarını ana makineye kurun:

```bash theme={null}
# Debian/Ubuntu
sudo apt install ffmpeg webp
# macOS
brew install ffmpeg webp
```

İndirdiğiniz dosyayı aynı sürümdeki `checksums.txt` ile doğrulayın. `./whatsapp version` sürümü yazdırır; `./whatsapp --help` tüm bayrakları listeler.

## Kaynak koddan

```bash theme={null}
git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.git
cd go-whatsapp-web-multidevice/src
cp .env.example .env    # optional
go build -o whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

macOS üzerinde derlemeden önce ayrıca `export CGO_CFLAGS_ALLOW="-Xpreprocessor"` çalıştırın.

### C araç zinciri olmadan ARM

`purego` derleme etiketi, tamamen Go ile yazılmış bir SQLite sürücüsü seçer; böylece CGO devre dışıyken çapraz derleme yapabilirsiniz:

```bash theme={null}
# Raspberry Pi 2/3/4 (ARMv7)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=7 go build -tags purego -o whatsapp-armv7
# Raspberry Pi Zero/1 (ARMv6)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=6 go build -tags purego -o whatsapp-armv6
```

## Depolama

Varsayılan olarak her şey `storages/` altında SQLite veritabanlarında tutulur:

| Veri | Varsayılan | Ayar |
| - | - | - |
| WhatsApp oturumları ve anahtarları | `file:storages/whatsapp.db` | `DB_URI` |
| Oturum anahtarı önbelleği (isteğe bağlı, ayrı veritabanı) | `DB_URI` kullanılır | `DB_KEYS_URI` |
| Sohbet geçmişi, cihaz kayıtları, zamanlamalar | `file:storages/chatstorage.db` | yapılandırılamaz |
| MCP OAuth istemcileri ve belirteçleri | `file:storages/oauth.db` | `MCP_OAUTH_DB_URI` |

`DB_URI`, PostgreSQL’i de kabul eder; örneğin `postgres://user:pass@host:5432/gowa?sslmode=verify-full`. Etkin bir TLS modu ayarlanmadığında uzak PostgreSQL oturum depolarında varsayılan olarak sertifika doğrulaması kullanılır. Açıkça belirtilen URI, ortam veya PostgreSQL hizmeti TLS ayarları geçerli olmaya devam eder. [Depolama yapılandırmasına](https://gowa-docs.mintlify.site/tr/configuration.md#depolama) bakın.

GOWA, SQLite dosyalarını yalnızca sahibine erişim veren `0600` izinleriyle, yeni üst dizinleri ise `0700` izinleriyle oluşturur. Mevcut dizinler izinlerini korur. Yeniden derlemeler arasında eşleştirilmiş cihazları korumak için `storages/` dizinini (veya PostgreSQL ile birlikte `storages/` dizinini) yedekleyin. Bu yedekleri kimlik bilgileri gibi koruyun.

## Ters vekil arkasında

GOWA’yı `APP_BASE_PATH` ile bir alt yolda sunun ve `APP_TRUSTED_PROXIES` ile vekilin ilettiği başlıklara güvenin:

```bash theme={null}
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password \
  --base-path=/gowa --trusted-proxies=10.0.0.0/8
```

```nginx theme={null}
location /gowa/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;     # WebSocket at /gowa/ws
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    client_max_body_size 100m;                  # largest upload GOWA accepts
}
```

`/health`, temel yoldan bağımsız olarak yoklamaların çalışması için kökte kalır (`/health` olarak; `/gowa/health` olarak değil).

Tarayıcı kaynak korumasının genel erişime açık ana makineyi bilmesi gerekir. Yukarıdaki gibi `Host` başlığını koruyun veya güvenilen bir vekilden `X-Forwarded-Host` gönderin. Ayrı barındırılan bir kontrol panelinin tam kaynağı `APP_TRUSTED_ORIGINS` veya `APP_CORS_ALLOWED_ORIGINS` içinde tanımlanmalıdır. Joker karakter, durum değişikliklerine veya WebSocket bağlantılarına izin vermez. `file://` sayfalarının güvenilmeyen `null` kaynağı olduğundan kontrol panelini HTTP veya HTTPS üzerinden sunun.

Varsayılan dinleyici, eksiksiz Basic Auth kimlik bilgileri olmadan başlamayı reddeder. `APP_ALLOW_UNAUTHENTICATED=true` ayarını yalnızca vekil çağrı yapanların kimliğini doğruluyorsa ve istemciler vekili atlayamıyorsa etkinleştirin. Kimlik doğrulamasız yerel geliştirme için `APP_HOST=127.0.0.1` adresine bağlayın.

## Doğrulama

```bash theme={null}
curl http://localhost:3000/health                      # OK, no auth needed
curl -u admin:changeme http://localhost:3000/app/info  # server info, no device needed
curl -u admin:changeme http://localhost:3000/devices   # registered devices
```

Depolama başlatıldığında `/health`, `OK` döndürür. Herhangi bir WhatsApp hesabının bağlı olup olmadığını bildirmez; bunun için `GET /devices/{device_id}/status` kullanın.

## Yükseltme

`storages/` dizinini yedekleyin, yeni imajı veya çalıştırılabilir dosyayı indirin ve yeniden başlatın. Önce uyumluluğu bozan değişiklikler için [sürüm notlarını](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases) okuyun. Öne çıkanlar: v6, `rest` alt komutunu zorunlu kıldı; v7, çalıştırılabilir dosyaları GoReleaser arşivlerine taşıdı; v8, çoklu cihaz desteği ekledi (birden fazla cihaz olduğunda cihaz kapsamlı çağrılar `X-Device-Id` gerektirir); bağımsız `whatsapp mcp` modu (`:8080/sse`) ise REST sunucusundaki `/mcp` uç noktasıyla değiştirildi.


## Related topics

- [Chatwoot Entegrasyonu](https://gowa-docs.mintlify.site/tr/integrations/chatwoot.md)
- [Hızlı başlangıç](https://gowa-docs.mintlify.site/tr/quickstart.md)
- [Üretim Ortamı İçin En İyi Uygulamalar](https://gowa-docs.mintlify.site/tr/advanced/best-practices.md)
- [Oturumlar ve Bağlantı Yaşam Döngüsü](https://gowa-docs.mintlify.site/tr/concepts/sessions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.