Sık Sorulan Sorular
Aşağıdaki sorular, kurulumlarda gerçekten karşılaşılan durumlardan derlenmiştir.
Kurulum ve erişim
Bölüm başlığı “Kurulum ve erişim”Sitede 502 hatası görüyorum
En sık neden .env içindeki JWT_SECRET veya APP_SECRET değerlerinin örnek değerde kalması ya da 32 karakterden kısa olmasıdır. Uygulama bu durumda üretim modunda hiç açılmaz. Node.js Selector’daki hata kaydında ilgili satırı görürsünüz. Her biri için size özel, uzun bir değer yazıp uygulamayı yeniden başlatın. Ayrıntı için Kurulum sayfasına bakın.
Veritabanına bağlanılamıyor
.env dosyasındaki DATABASE_URL içinde kullanıcı adı, parola, sunucu ve veritabanı adını kontrol edin; değiştirdiyseniz uygulamayı yeniden başlatın. Parolada özel karakter varsa adres içinde uygun biçimde kodlanması gerekir.
Kurulum sihirbazı kapandı, bir şeyi değiştirmek istiyorum
Sihirbaz bir kez tamamlanınca kilitlenir. Lisansı Ayarlar → Lisans, Minecraft sunucusu anahtarlarını Mağaza → Katalog → Oyun Sunucuları sayfasından yönetirsiniz.
Yönetici parolamı unuttum
Giriş sayfasındaki parola sıfırlama bağlantısını kullanın. Bunun için SMTP ayarının yapılmış olması gerekir.
Cloudflare kullanıyorum, birinin hatalı girişi herkesi kilitledi
Hız sınırları ziyaretçi IP’sine göre sayılır. Cloudflare arkasında .env dosyasına TRUSTED_IP_HEADER="cf-connecting-ip" yazın; yazılmazsa tüm ziyaretçiler Cloudflare’in IP’si altında tek sayaca düşer. Cloudflare kullanmıyorsanız bu satırı boş bırakın.
Lisans
Bölüm başlığı “Lisans”Site 'bu alan adı bu lisansta beyan edilmedi' diyor
Lisans alan adına bağlıdır. .env içindeki SITE_URL sitenizin gerçek adresi olmalı ve aynı alan adı koderia.dev portalında lisansınıza tanımlı olmalıdır. Düzelttikten sonra uygulamayı yeniden başlatıp Ayarlar → Lisans sayfasında Şimdi doğrula’ya basın. Ayrıntı: Lisans.
Site kilitli açıldı, yönetim paneline giremiyorum
Lisans sayfası ve giriş sayfası kilit altında bile açık kalır. Yönetici olarak giriş yapıp Ayarlar → Lisans sayfasından durumu görün, anahtarı girin veya Şimdi doğrula’ya basın.
Ödeme gecikti, site kapanır mı?
Hemen kapanmaz. Panelde kırmızı bir uyarı çıkar ve ödemesiz süre boyunca site çalışır; süre bitince kilitlenir. Koderia’ya geçici olarak ulaşılamazsa site eldeki lisansla en fazla 7 gün çalışır.
Alt bilgideki 'Powered by Koderia' yazısını kaldırabilir miyim?
Hayır. Bu yazı lisans şartlarının parçasıdır; kaldırılamaz veya gizlenemez.
Mağaza ve teslimat
Bölüm başlığı “Mağaza ve teslimat”Oyuncu ödeme yaptı ama ürün oyunda gelmedi
- Mağaza → Satışlar → Teslimat Kuyruğu sayfasında teslimatın durumuna bakın.
- Mağaza → Katalog → Oyun Sunucuları sayfasında sunucunun çevrimiçi göründüğünü kontrol edin. Eklentiden son 90 saniyede sinyal gelmediyse sunucu kapalı veya eklenti kurulu değildir.
- Eklentideki
api-key,secret-keyveserver-iddeğerlerinin panelle birebir aynı olduğunu doğrulayın.
Eklenti yanıt vermezse teslimat 2 dakika sonra kendiliğinden yeniden sıraya girer; başarısız olanlar artan aralıklarla yeniden denenir ve 5 denemeden sonra yöneticiye bildirim düşer. Ayrıntı: Minecraft eklentisi.
Ödeme sağlayıcısından dönüş yapılıyor ama sipariş ödenmiş görünmüyor
Sağlayıcının bildirim (webhook) adresi sağlayıcı panelinde doğru tanımlı olmalı ve sitenize erişebilmelidir. Kilitli bir sitede bile ödeme bildirimleri kabul edilir, bu yüzden önce sağlayıcının bildirim kaydına bakın. Sağlayıcıya özgü adımlar için ilgili ödeme yöntemi sayfasına bakın.
E-posta ve bildirimler
Bölüm başlığı “E-posta ve bildirimler”Parola sıfırlama ve doğrulama e-postaları gelmiyor
SMTP ayarının yapıldığından emin olun. Gönderilemeyen e-postalar kaybolmaz: Ayarlar → Dış Etki Kuyruğu sayfasında görüp elle yeniden gönderebilirsiniz.
Discord bildirimi gitmiyor
Webhook adresi yalnızca bir discord.com webhook adresi olabilir. Geçici hatalarda mesaj kuyruğa alınıp otomatik yeniden denenir; kalıcı hatalarda (silinmiş webhook gibi) denenmez. Ayrıntı: Discord webhook.
Turnstile kutusu görünmüyor
Site anahtarı ve gizli anahtar girilmeden, ayrıca Turnstile doğrulaması açılmadan kutu gösterilmez. Hız sınırı ve gizli tuzak alan ise her zaman çalışır. Ayrıntı: Cloudflare Turnstile.
Google Analytics verilerim düştü
Çerez onay bandı açıksa Google Analytics yalnızca ziyaretçi “izleme” çerezlerini kabul edince yüklenir. Düşüşün nedeni genellikle budur. Ayrıntı: Google Analytics.
Güncelleme ve yedek
Bölüm başlığı “Güncelleme ve yedek”Güncelleme 'Disk quota exceeded' ile düştü
Barındırma kotanız dolmuştur. Eski sürüm kopyalarını silmek için Güncellemeler sayfasındaki sık sorunlar bölümüne bakın.
Güncellemeden sonra site bozuldu
Yeni sürüm açılmazsa sistem kendiliğinden önceki sürüme döner. Elle dönmek için Ayarlar → Güncellemeler sayfasındaki Geri al düğmesini kullanın. Geri alma veritabanına dokunmaz.
Veritabanı yedeğini nasıl geri yüklerim?
Ayarlar → Yedekler sayfasından yedeği indirin; cPanel’de phpMyAdmin’i açıp İçe aktar ile yükleyin (sıkıştırılmış .sql.gz dosyası doğrudan kabul edilir). Yedek yalnızca veritabanını kapsar; public/uploads içindeki görselleri ayrıca saklayın.
Adresler ve dil
Bölüm başlığı “Adresler ve dil”Sayfa adresleri neden İngilizce?
1.0.42 sürümünden itibaren sayfa adresleri İngilizcedir (/login, /store, /support/tickets gibi). Eski Türkçe adresler çalışmaya devam eder ve yeni adrese yönlendirilir; yer imleri ve ödeme dönüş adresleri bozulmaz. Adrese ?lang=tr veya ?lang=en ekleyerek sayfanın dilini değiştirebilirsiniz.