> ## Documentation Index
> Fetch the complete documentation index at: https://developer.leaderos.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Yayına Alma (VDS)

> Oluşturduğunuz temayı kendi VDS/VPS sunucunuzda Node.js, PM2 ve Nginx ile yayınlayın.

> [!WARNING]
>
> **LeaderOS Web Hosting (paylaşımlı hosting) üzerinde çalışmaz.** Next.js temalarının sürekli çalışan bir **Node.js süreci** gerekir ve paylaşımlı hostingte Node.js sunucusu çalıştırılamaz. Temanızı kendi **VDS/VPS** veya Node.js destekleyen bir platformda yayınlamalısınız. LeaderOS sitenizin kendisi (API, yönetim paneli) mevcut hostingte çalışmaya devam eder.

## Mimari

```
Oyuncu ──► https://shop.example.com  (VDS: Nginx → Next.js :3000)
                 │  sunucudan sunucuya
                 ▼
          https://play.example.com/headless/v1  (LeaderOS sitesi, mevcut hosting)
```

* **LeaderOS sitesi** (`play.example.com`): API, yönetim paneli, ödeme geri aramaları. Çalışmaya devam etmelidir.
* **Tema** (`shop.example.com`): oyuncuların girdiği adres. Veriyi LeaderOS'tan çeker.

## Gereksinimler

| Gereksinim | Öneri |
| - | - |
| İşletim sistemi | Ubuntu 22.04 / 24.04 (veya benzeri Linux) |
| Kaynak | En az 1 vCPU, 1–2 GB RAM (derleme için 2 GB önerilir) |
| Node.js | 20 LTS veya üzeri (minimum 18.18) |
| Alan adı | Temanız için bir alan adı/alt alan adı (ör. `shop.example.com`), sunucuya yönlendirilmiş |
| Erişim | SSH, root veya sudo yetkisi |

## 1. Sunucuyu hazırlayın

```bash theme={null}
sudo apt update && sudo apt upgrade -y
sudo apt install -y nginx git curl

# Node.js 20 (NodeSource)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# PM2 (süreç yöneticisi)
sudo npm install -g pm2
```

## 2. Projeyi sunucuya alın

> [tab] Git ile
>
> ```bash theme={null}
> cd /var/www
> sudo git clone https://github.com/kullanici/my-theme.git
> sudo chown -R $USER:$USER my-theme
> cd my-theme
> ```

> [tab] Dosya yükleyerek
>
> `node_modules` ve `.next` klasörlerini hariç tutarak projeyi `scp`/`rsync` ile gönderin:
>
> ```bash theme={null}
> rsync -av --exclude node_modules --exclude .next ./my-theme/ kullanici@sunucu:/var/www/my-theme/
> ```

## 3. Ortam değişkenleri

Sunucuda `/var/www/my-theme/.env.production` oluşturun:

```bash theme={null}
LEADEROS_URL=https://play.example.com
LEADEROS_PUBLIC_KEY=pk_live_XXXXXXXX
SITE_URL=https://shop.example.com
```

| Değişken | Açıklama |
| - | - |
| `LEADEROS_URL` | LeaderOS sitenizin adresi |
| `LEADEROS_PUBLIC_KEY` | Panelden kopyaladığınız anahtar |
| `SITE_URL` | Temanızın genel adresi (sitemap ve robots için) |

> [!NOTE]
>
> `.env*` dosyalarını Git'e eklemeyin. Anahtarı yenilerseniz bu dosyayı güncelleyip uygulamayı yeniden başlatın.

## 4. Derleyin ve başlatın

```bash theme={null}
npm ci          # veya npm install
npm run build
pm2 start npm --name leaderos-theme -- start
pm2 save
pm2 startup     # çıkan komutu çalıştırın: sunucu yeniden başlayınca otomatik açılır
```

Uygulama varsayılan olarak `3000` portunda çalışır. Farklı port için: `PORT=3100 pm2 start npm --name leaderos-theme -- start`.

## 5. Nginx ters vekil (reverse proxy)

`/etc/nginx/sites-available/leaderos-theme`:

```nginx theme={null}
server {
    listen 80;
    server_name shop.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
```

```bash theme={null}
sudo ln -s /etc/nginx/sites-available/leaderos-theme /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
```

> [!TIP]
>
> `X-Forwarded-For` başlığı önemlidir: tema, ziyaretçinin gerçek IP adresini LeaderOS'a bu başlıkla iletir (kayıt limiti, loglar vb.). Cloudflare kullanıyorsanız gerçek IP'yi doğru ilettiğinizden emin olun.

## 6. SSL (HTTPS)

```bash theme={null}
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d shop.example.com
```

Sertifika otomatik yenilenir. Canlı sitede HTTPS **zorunludur**; aksi halde çerezler ve ödeme sağlayıcıları sorun çıkarır.

## 7. LeaderOS panelini yapılandırın

**Ayarlar → Headless API** sayfasında:

**1. Frontend URL**

`https://shop.example.com` yazın. E-posta bağlantıları ve ödeme dönüşleri artık temanıza gelir.

**2. Sayfa yolları**

Şablondaki varsayılanları kullanıyorsanız dokunmayın; değiştirdiyseniz aynı yolları girin.

**3. Origin'ler**

Proxy kullanan şablonda gerekmez. Tarayıcıdan doğrudan API'ye istek atıyorsanız `https://shop.example.com` ekleyin. **"Tüm origin'lere izin ver" kapalı olmalıdır.**

## 8. Ödeme sağlayıcıları

* **Tarayıcı dönüşü**: oyuncu ödeme sonrası temanızdaki `/payment/success` ve `/payment/error` sayfalarına döner.
* **Sunucu bildirimleri (callback/webhook)** LeaderOS'a gelmeye devam eder: PayTR bildirim URL'si, Stripe/Shopier webhook'u vb. **mevcut ayarlarınızı değiştirmeyin**; hâlâ LeaderOS sitenizi göstermelidir.
* Ödeme akışını yayına almadan önce küçük bir tutarla uçtan uca deneyin.

## Güncelleme

```bash theme={null}
cd /var/www/my-theme
git pull
npm ci
npm run build
pm2 restart leaderos-theme
```

## Sorun giderme

| Belirti | Olası neden |
| - | - |
| 502 Bad Gateway | Uygulama çalışmıyor: `pm2 logs leaderos-theme` |
| Sayfalar boş / `INVALID_API_KEY` | `.env.production` anahtarı yanlış veya anahtar yenilenmiş |
| `LICENSE_INVALID` (402) | LeaderOS sitenizin lisansı/alan adı |
| E-posta bağlantıları eski adrese gidiyor | Panelde Frontend URL ayarlanmamış |
| Derleme sırasında bellek hatası | 2 GB RAM veya swap ekleyin |
| Girişten sonra oturum düşüyor | HTTPS yok veya proxy `X-Forwarded-Proto` iletmiyor |

> [!WARNING]
>
> Footer'daki "Powered by LeaderOS" bağlantısını yayına almadan önce kontrol edin. Gizlenirse sayfa bir uyarı ile değiştirilir.


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