Sık karşılaşılan sorunlar

Kurulum komutu hataları, açılmayan site, HTTPS, kurulum anahtarı, lisans hataları, kilitli panel, e-postalar ve başarısız güncellemeler.

Burada en sık görülen sorunları ve çözümlerini bulursun. Mesajlar, ekranda gördüğün haliyle yazıldı; sayfada aramak için mesajın bir parçasını kullanabilirsin. Çözüm bulamazsan Günlükler ve destek sayfasına geç.

Kurulum komutu hata veriyor#

Kurulum komutu bir sorunda durur ve kırmızı bir HATA: satırı yazar:

Mesaj	Ne yapmalı?
root olarak çalıştırın (komutun başında sudo var mı?).	Komutu borcube.com'dan kopyaladığın gibi, içindeki `sudo` ile çalıştır.
Ubuntu 22.04 ya da 24.04 gerekli.	Sunucuya bu sürümlerden birini kur.
Şimdilik yalnız x86_64 (amd64) sunucular destekleniyor.	ARM işlemcili sunucular desteklenmez; x86_64 bir sunucu seç.
80/443 portlarını başka bir program kullanıyor (Apache/Nginx?):	Mesajın altında portu tutan program yazar. Onu durdur ya da kaldır, komutu yeniden çalıştır.
İndirilemedi. Bağlantı 10 dakika geçerli: borcube.com'dan yeni komut alın.	Hesabım → İndirmeler sayfasında yeni komut oluştur.
Paket doğrulanamadı (SHA-256 uyuşmuyor).	Yeni komut oluştur ve tamamını kopyala.
Başka bir BorCube kurulumu ya da güncellemesi sürüyor; bitince tekrar deneyin.	Süren işin bitmesini bekle.
Caddy çalışmıyor.	Komut, Caddy günlüğünün son satırlarını üstüne yazar. Nedeni orada görürsün.

Gereksinimler için Gereksinimler sayfasına bak.

Site açılmıyor#

Sırayla şunlara bak.

Alan adı: Kurulum komutu sonunda Alan adı: … → … (bu sunucu: …) satırını yazar. İki IP adresi aynı değilse alan adının DNS A kaydını sunucunun IP adresine yönlendir. Bu özet /root/borcube-kurulum.txt dosyasında da durur:

Komut

sudo cat /root/borcube-kurulum.txt

Servisler: borcube, caddy ve mysql servislerinin üçü de çalışıyor (active (running)) olmalı:

Komut

sudo systemctl status borcube caddy mysql

Güvenlik duvarı: Sunucuda UFW açıksa kurulum komutu 80 ve 443 portlarını kendisi açar. Sunucu sağlayıcının panelinde ayrı bir güvenlik duvarı varsa bu portları orada da aç.

Adres: Siteyi alan adıyla aç. IP adresiyle açarsan adres lisanstaki alan adıyla uyuşmaz ve bakım sayfası görürsün.

HTTPS sertifikası alınamıyor#

HTTPS sertifikasını Caddy alır. DNS kaydı sunucuyu gösterince sertifika kendiliğinden alınır; senin bir şey yapman gerekmez. Sorunun nedenini Caddy günlüğünde görürsün:

Komut

sudo journalctl -u caddy -n 50

Alan adın Cloudflare proxy'si (turuncu bulut) arkasındaysa kurulum komutunun sonuna --cloudflare ekle. Ayrıntılar: Alan adı ve HTTPS.

Kurulum anahtarını bulamıyorum#

Kurulum sihirbazının ilk adımı bir kurulum anahtarı ister. Tek komutla kurduysan anahtar şu dosyadadır:

Komut

sudo cat /var/lib/borcube/install-token.txt

Anahtar /root/borcube-kurulum.txt dosyasında da yazar. Docker kurulumunda docker compose logs borcube | grep "Kurulum anahtarı" komutuyla bulursun. Yanlış anahtar girersen "Kurulum anahtarı hatalı." uyarısı çıkar. Kurulum tamamlanınca anahtar silinir ve sihirbaz kapanır. Ayrıntılar: Kurulum sihirbazı.

Lisans hataları#

Bu mesajlar kurulum sihirbazının Lisans adımında ya da Yönetim paneli → Ayarlar → Lisans sayfasında görünür:

Mesaj	Ne yapmalı?
Lisans anahtarı BC-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX biçiminde olmalı.	Anahtarı eksiksiz kopyala; başındaki `BC-` dahil.
Lisans anahtarı geçersiz.	Anahtarı Hesabım → Lisanslarım sayfasından yeniden kopyala.
Bu lisans başka bir alan adına bağlı. …	Site adresi lisanstaki alan adıyla aynı olmalı. Alan adını değiştirmek için Alan adı değiştirme makalesine bak.
Bu lisans izin verilen kurulum sayısına ulaştı. …	Lisans sayfanın Kurulumlar bölümünde eski kurulumu Kaldır ile sil.
Bu lisansın süresi dolmuş. …	Lisansını uzat: Süre uzatma.
Bu kurulum etkin değil. Lisans anahtarını yeniden girin.	Kurulum hesabından kaldırılmış ya da alan adı değişmiş. Anahtarı Ayarlar → Lisans sayfasında yeniden gir.
Bu lisans askıya alınmış. …	Destekle iletişime geç.
Bu lisans iptal edilmiş.	Destekle iletişime geç.
Lisans sunucusuna ulaşılamadı. …	Sunucunun internet bağlantısını denetle ve yeniden dene. Lisansı önceden etkinleşmiş bir site bu sırada 7 gün normal çalışır.
Çok fazla istek. Biraz sonra tekrar deneyin.	Birkaç dakika bekleyip yeniden dene.

Panel kilitli ya da site bakımda#

Panel kilitliyse Panel kilitli ekranı görünür. /admin/login adresinden giriş yapabilirsin; site ayarlarını yönetme yetkin varsa kilit ekranında lisans kartı da görünür. Nedeni kartın Durum satırında yazar:

Durumda yazan	Oyuncu sitesi	Ne yapmalı?
Abonelik sona erdi	İlk 3 gün açık; sonra uyarı bandı; bitişten 14 gün sonra bakım sayfası	Lisansını uzat, sonra Şimdi yenile düğmesine bas.
Doğrulanamadı — belirteç yenilenemedi, süresi doldu	Açık, uyarı bandıyla	"Son yenileme:" satırındaki nedene bak ve Şimdi yenile düğmesine bas.
Doğrulanamadı — lisans yok ya da bozuk	Bakım sayfası	Lisans anahtarını gir ve Etkinleştir düğmesine bas.
Doğrulanamadı — site adresi lisanstaki alan adıyla uyuşmuyor	Bakım sayfası	Siteyi lisanslı alan adıyla aç ya da alan adını değiştir.
Doğrulanamadı — lisans başka bir kuruluma ait	Bakım sayfası	Lisans anahtarını yeniden gir.

Bakım sayfasında "Bu site geçici olarak hizmet dışı." yazar. Panele girme yetkisi olan bir hesapla giriş yaptıysan site sana normal görünür. Ayrıntılar: Lisans nasıl çalışır?.

E-postalar gitmiyor#

Yönetim paneli → Ayarlar → SMTP sayfasını aç. E-posta gönderimini etkinleştir açık olmalı.
SMTP sunucusu, Port, Kullanıcı adı, Şifre ve Gönderen e-posta alanlarını e-posta sağlayıcının verdiği bilgilerle doldur. Port 465 ise SSL/TLS (port 465) seçeneğini aç; 587 ise kapalı bırak.
Kaydet düğmesine, sonra Test e-postası gönder düğmesine bas. Test e-postası kendi hesabının adresine gider.

"Gönderilemedi. Sunucu, port, şifreleme ve kimlik bilgilerini kontrol edin." uyarısı alırsan bu bilgilerden biri yanlıştır.

Bütün denemelere rağmen gönderilemeyen e-postalar Yönetim paneli → Kayıtlar → Hata veren işler sayfasında email.send işi olarak görünür. Son hata sütunu nedeni yazar. Orada SMTP is not configured görürsen e-posta gönderimi kapalıdır ya da SMTP sunucusu boştur. Ayrıntılar: E-posta.

Güncelleme başarısız oldu#

Panelde Kurulamadı görürsen siten önceki sürümle çalışmaya devam eder. Nedeni mesajda ve Kurulum çıktısı bölümünde yazar.

Bekliyor ve "Sunucudaki güncelleme servisi isteği almadı." görürsen İsteği iptal et düğmesine bas. Sonra Hesabım → İndirmeler sayfasındaki kurulum komutunu sunucuda bir kez çalıştır ve yeniden dene.
"Güncelleme yanıt vermeden kaldı." görürsen sunucuda sudo journalctl -u borcube-update komutuyla güncelleme servisinin günlüğüne bak.
"Diskte yer yok: …" görürsen sunucuda yer aç ve yeniden dene.
"Bu sürüm lisansınızın güncelleme süresinden sonra çıktı. …" görürsen güncelleme yenilemesi al: Süre uzatma.

Yeni sürüm açılmayıp eski sürüme dönüldüyse ve site düzgün çalışmıyorsa veritabanını güncellemeden önceki yedekten geri yükle: Veritabanını geri yüklemek. Güncellemenin nasıl çalıştığı: Güncellemeler.

ÖncekiLiquid referansı Sonraki Günlükler ve destek

Bir yanlış ya da eksik mi gördün? Discord’dan haber ver, hemen düzeltelim.