first commit

DOKPLOY_TROUBLESHOOTING.md

@@ -0,0 +1,107 @@
+# Dokploy Troubleshooting Guide
+
+## PostgreSQL Bağlantı Sorunları
+
+### Hata: `ECONNREFUSED` veya `Failed query`
+
+Bu hata, uygulamanın PostgreSQL sunucusuna bağlanamadığını gösterir.
+
+### Kontrol Listesi
+
+1. **DATABASE_URL Environment Variable Kontrolü**
+
+   Dokploy'da environment variables bölümünde `DATABASE_URL` değerini kontrol edin:
+   
+   ```bash
+   # Doğru format:
+   DATABASE_URL=postgresql://user:password@host:port/database?search_path=public
+   
+   # Örnek:
+   DATABASE_URL=postgresql://cloud:gg7678290@10.80.80.70:5432/image_api?search_path=public
+   ```
+
+2. **Network Erişimi**
+
+   - Dokploy container'ından PostgreSQL sunucusuna erişilebilir olmalı
+   - Eğer PostgreSQL farklı bir network'teyse, network yapılandırmasını kontrol edin
+   - Firewall kurallarını kontrol edin (port 5432 açık olmalı)
+
+3. **IP Adresi ve Port**
+
+   - Hata mesajında görünen IP/port ile DATABASE_URL'deki IP/port eşleşmeli
+   - Eğer farklıysa, Dokploy'da environment variable'ı güncelleyin
+
+4. **Connection String Formatı**
+
+   ```bash
+   # ✅ Doğru
+   postgresql://user:password@10.80.80.70:5432/dbname
+   
+   # ❌ Yanlış
+   postgres://user:password@10.80.80.70:5432/dbname  # postgres yerine postgresql kullanın
+   postgresql://user:password@10.80.80.70/dbname     # Port eksik
+   ```
+
+5. **Schema Belirtme**
+
+   Eğer `public` dışında bir schema kullanıyorsanız:
+   ```bash
+   DATABASE_URL=postgresql://user:password@host:port/dbname?search_path=your_schema
+   ```
+
+### Dokploy'da Environment Variables Ayarlama
+
+1. Dokploy dashboard'a giriş yapın
+2. Projenizi seçin
+3. "Environment Variables" bölümüne gidin
+4. `DATABASE_URL` değerini kontrol edin/güncelleyin
+5. Değişikliklerden sonra container'ı yeniden başlatın
+
+### Test Komutları
+
+Container içinden bağlantıyı test etmek için:
+
+```bash
+# Container'a bağlan
+docker exec -it image-api-app sh
+
+# PostgreSQL bağlantısını test et
+psql $DATABASE_URL -c "SELECT version();"
+```
+
+### Yaygın Hatalar ve Çözümleri
+
+**Hata:** `ECONNREFUSED 10.0.1.215:5455`
+- **Sebep:** DATABASE_URL yanlış IP/port içeriyor
+- **Çözüm:** Dokploy'da DATABASE_URL'i doğru IP ve port ile güncelleyin
+
+**Hata:** `timeout expired`
+- **Sebep:** Network erişim sorunu veya firewall
+- **Çözüm:** Network yapılandırmasını ve firewall kurallarını kontrol edin
+
+**Hata:** `password authentication failed`
+- **Sebep:** Yanlış kullanıcı adı/şifre
+- **Çözüm:** DATABASE_URL'deki credentials'ları kontrol edin
+
+### Örnek Doğru DATABASE_URL
+
+```bash
+# Local PostgreSQL
+DATABASE_URL=postgresql://postgres:password@localhost:5432/image_api?search_path=public
+
+# Remote PostgreSQL
+DATABASE_URL=postgresql://cloud:gg7678290@10.80.80.70:5432/image_api?search_path=public
+
+# SSL ile
+DATABASE_URL=postgresql://user:pass@host:5432/dbname?sslmode=require
+```
+
+### Debug Modu
+
+Daha detaylı hata mesajları için:
+
+```bash
+# db.ts dosyasında pool.on('error') event handler'ı logları gösterir
+# Container loglarını kontrol edin:
+docker logs image-api-app
+```