Yardım

Sorun giderme

Dağıtım başarısız olunca ne yapmalı, sık karşılaşılan sorunlar ve Turguz'un tanıdığı hata özetlerinin listesi.

Turguz bir işlemi yapamadığında ne olduğunu, nedenini ve ne yapmanız gerektiğini söylemeye çalışır. Bu sayfa o mesajları nerede bulacağınızı, en sık sorunları ve Turguz'un tanıdığı hata özetlerini toplar.

#Dağıtım başarısız olursa

Özeti okuyun
Ortamın Dağıtımlar sekmesinde «Hata» durumundaki dağıtım kısa bir özetle gelir: ne oldu, neden ve ne yapmalı. Özet tanınan bir durumsa yanında «Belgede oku» bağlantısı çıkar ve sizi aşağıdaki hata özetleri listesinde o duruma getirir. Aynı bağlantı mobil uygulamanın dağıtım ekranında da vardır.
Önerilen yere gidin
Özetin yanında çoğu zaman sizi doğru yere götüren bir düğme vardır: «Yeniden derle», «Veritabanı ayarlarına git» ya da «Ortam değişkenlerine git».
Günlüğe bakın
Ayrıntı için Günlükler sekmesinde «Derleme günlüğü» ve «Canlı günlük» çıktısını okuyun.
Düzeltip yeniden deneyin
Projeyi düzeltip yeniden gönderin ya da «Yeniden derle». Derleme düşerse yayındaki sürüm çalışmaya devam eder.

#Site açılmıyor

Uygulamanız PORT değişkenindeki kapıyı ve 0.0.0.0 adresini dinlemeli: Port ve adres.
Ortam durdurulmuş olabilir; ortamın başlığındaki «Başlat» ile açın.
Site yalnız belirli adreslere açılmış olabilir: İnternet erişimi.
Yeni bir sürüm yayına çıkıyorsa, uygulama açılana kadar birkaç saniye bekleyin.
Ziyaretçi "Site şu an yanıt vermiyor" sayfasını görüyorsa uygulamanız istekleri karşılayamıyor ya da kendisi 502 veya 503 yanıtı veriyor; Günlükler sekmesindeki «Canlı günlük» çıktısına bakın. Ayrıntı: Site açılırken ve kapalıyken.

#Uygulama dış bir hizmete ulaşamıyor

Ortamlar ve sunucular varsayılan olarak internete kapalıdır; günlükte yalnız zaman aşımı görünür. Erişim isteyin: İnternet erişimi.

#Kota yetmiyor

Kota yetmeyen işlem yapılmaz. Ne yapacağınız: Kota yetmezse.

#SSH bağlantısı reddediliyor

Sunucu, kendisine yazılan anahtarlardan biriyle ya da açarken verdiğiniz parolayla giriş kabul eder. Anahtarınızı panele eklediyseniz Ayarlar sayfasındaki SSH anahtarlarım bölümüne bakın: anahtarınız bir sunucuya kendiliğinden ulaşmıyorsa orada o sunucu ve ne yapacağınız yazar. Hiçbir yoldan giremiyorsanız tarayıcıdaki konsolu kullanın. Ayrıntı: Bağlanmak.

#Projenin ihtiyaçları

Yayından önce sorunları görmek için ortamın Hazırlık bölümüne bakın: Hazırlık raporu.

#Yardım istemek

Çözemediğiniz bir sorunu platform yöneticinize iletirken ortamın ya da sunucunun adını, sorunun zamanını ve paneldeki mesajı ekleyin.

#Hata özetleri

Aşağıdaki liste, Turguz'un başarısız bir dağıtımda tanıdığı durumları ailelerine göre sıralar. Bazı durumların özeti projenize göre yazılır; onlar için yalnız başlık var.

#Deponun düzeni

Turguz deponuzda uygulamayı nerede ve nasıl bulacağını çıkaramadı: uygulama klasörü, alt modül ya da başka bir platformun ayar dosyası. Özet ne bulunduğunu söyler. Uygulama klasörünü ortamın Ayarlar › Derleme ve çalıştırma bölümündeki «Uygulama klasörü» alanından verin.

#Uygulama MySQL veritabanı istiyor

#PHP sitesi kökten sunulamaz

#PHP projesinde public/index.php yok

#Dockerfile'daki pip paket deposunu okuyamıyor

#Dockerfile'ın çalıştırdığı dosyada çalıştırma izni yok

#Dockerfile'daki bir adım düştü

#Depo alt modül kullanıyor

#Uygulama klasörü dışındaki dosyalara başvuru

#Derleme

Turguz projeyi derlerken durdu. Projenin dilinin tanındığını ve uygulama klasörünün doğru olduğunu denetleyin; gerekiyorsa derleme komutunu ortamın Ayarlar › Derleme ve çalıştırma bölümünden verin. Düzelttikten sonra «Yeniden derle».

#Derleme süre sınırını aştı

#Derlemenin çalışma alanı doldu

#Composer betiği derlemede düştü

#Proje dosyası hedef çatıyı yazmıyor

#Derleme veritabanını da güncelliyor

#Derleme kodun git geçmişine soruyor

#SvelteKit derlemede ortam değişkenlerini doğruluyor

#Go ana programı uygulama klasörünün kökünde değil

#Derleme ortamında olmayan bir programı çağırıyor

#Clojure projesinin derleme yolu tanımlı değil

#Derleme uygulamanın ayarlarını doğruluyor

#Alt klasörlerdeki projelerin paketleri kurulmuyor

#Derleme komutunun çağırdığı program bulunamadı

#Derleme betiğinin çağırdığı program derleme ortamında yok

#Derleme betiği geliştirme paketini bulamadı

#Next.js yapılandırmasında yalnız Turbopack'te geçerli seçenek var

#Next.js derlemesi webpack ile yapılır

Derleme durdu: derleme betiğiniz Turbopack'i seçiyor (next build --turbopack), Turbopack bu derleme ortamında çalışmaz. Betiği "build": "next build --webpack" yapın ya da --turbopack bayrağını kaldırın; NODE_ENV için bir şey yapmanız gerekmez. next.config'e turbopack.root ayarı EKLEMEYİN, ekliyse KALDIRIN: uygulama çalışırken dış paketleri bulamaz.

#Next.js derlemesi üretim kipinde yapılır

Derleme durdu: NODE_ENV=development ile koştu ve sayfalar önceden üretilirken çöktü. Ortam değişkenlerinizde NODE_ENV tanımlıysa silin ya da production yapın; Turguz sizin değerinize dokunmaz. Tanımlı değilse package.json'da "build": "NODE_ENV=production next build" yazın; Next.js 16'da sonuna --webpack ekleyin.

#Node'un belleği yetmedi

#Eski derleme aracı yeni Node ile çalışmıyor

#Kodda TypeScript tür hatası var

#Tarayıcı derlemede eklenemedi

#Django statik dosyaları toplayamadı

#Klasörde birden çok .NET projesi var

.NET derlemesi durdu: uygulama klasöründe birden çok proje ya da çözüm dosyası var, Turguz hangisini derleyeceğini seçemedi. Derlenecek projenin klasörünü ortam değişkenlerinde BP_DOTNET_PROJECT_PATH ile seçin (ör. src/App). İki uygulama projesi aynı klasördeyse (ör. Api.csproj ile Isci.csproj) birini ayrı bir klasöre taşıyın.

#Derleme sırasında veritabanına bağlanılmak istendi

Derleme durdu: veritabanına bağlanmaya çalıştı, veritabanı yalnız uygulama çalışırken hazır. Veri çeken sayfaları derlemeden çıkarın (dinamik yapın).

#Projenin dili tanınamadı

Derleme başlamadı: projenin dili tanınamadı, uygulama klasöründe package.json gibi bir dosya ya da index.html yok. Uygulama bir alt klasördeyse onu Ayarlar › Uygulama klasörü ile seçin; kökteki nginx.conf, Dockerfile ve docker-compose.yml dikkate alınmaz. Turguz bazı diller için kendi Dockerfile'ını önerebilir: Hazırlık kartına bakın.

#Paketler ve bağımlılıklar

Bağımlılıklar kurulamadı. Kilit dosyanızın depoda ve güncel olduğunu denetleyin. Önbellekten şüpheleniyorsanız yeniden derlerken bağımlılıkları sıfırdan kurdurun.

#Paket bu sitenin paket aynasında yok

#Paket aynası bu derlemeye eklenmedi

#Projede go.sum eksik ya da güncel değil

#Projenin go.mod dosyası içe aktarılan bir paketin modülünü listelemiyor

#Depoda composer.lock dosyası yok

#Uygulama çalışma alanındaki kendi paketlerini dışarıdan isterdi

#Kilit dosyasında kötü amaçlı paket var

#Kilit dosyası okunamadı, paketler denetlenemedi

#İstenen PHP eklentisi derleme ortamında yok

#Ruby 3.4'te ayrı pakete dönen gem yüklenemedi

#Paket listesinin geçerlilik süresi doldu

Derleme düştü: Dockerfile'daki apt-get update, paket listesinin geçerlilik süresi dolduğu için durdu. Bu sunucu internete kapalı; paket listesi platform güncellenince tazelenir. FROM satırı Turguz'un tanıdığı bir temel (node, python, php, debian …) ise bu kendiliğinden çözülür; başka bir temel kullanıyorsanız Dockerfile'da apt-get -o Acquire::Check-Valid-Until=false update yazın.

#Proje pnpm ile kurulur

pnpm komutu çalışmadı: bu projede pnpm kurulmadı. Turguz pnpm'i yalnız pnpm-lock.yaml tek kilit dosyasıyken ya da packageManager alanı pnpm diyorken kurar. Öteki kilit dosyalarını (package-lock.json, yarn.lock) kaldırın ya da package.json'a "packageManager": "pnpm@<sürüm>" yazın.

#Uygulama klasörü bir pnpm çalışma alanının içinde

Bağımlılıklar kurulamadı: proje pnpm çalışma alanındaki başka bir pakete (workspace:) bağlı, o paket seçilen klasörün dışında. Uygulama klasörünü çalışma alanının kökü yapın. Derleme komutuna pnpm --filter <paket> build, başlatma komutuna pnpm --filter <paket> start yazın.

#Proje Yarn'ın 2 ya da daha yeni sürümüyle kurulur

#Proje bun ile kurulur

#Kilit dosyası package.json ile uyuşmuyor

#Paketlerin istediği sürümler çatışıyor

#Bağımlılık bir git deposundan kuruluyor

#Görüntü kitaplığı sharp yüklenemedi

#Prisma istemcisinin üretimi

#Prisma'nın ayar dosyası derlemede bir değişken istiyor

#Eksik Node modülü

Uygulama bir Node modülünü bulamadı: paket kurulmamış ya da package.json'da yok. Eksik paketi package.json'daki dependencies bölümüne ekleyin.

#Projenin kendi Python modülü bulunamadı

#Eksik Python paketi

#Bağımlılık kurulumu (npm) başarısız

Bağımlılıklar kurulamadı: npm hata verdi. Ayrıntıdaki npm satırına bakın ve package.json'daki paketi ya da sürümü düzeltin.

#Dil sürümü

Projenin istediği dil sürümüyle ilgili bir sorun. Özet, sürümün nereden okunduğunu ve neyin değişmesi gerektiğini söyler.

#İstenen PHP sürümü derleme ortamında yok

#Bağımlılıklar başka bir PHP sürümü istiyor

#İstenen Java sürümü derleme ortamında yok

#İstenen Ruby sürümü derleme ortamında yok

#.NET SDK beyanı derleme ortamına uyarlanır

#İstenen .NET SDK sürümü derleme ortamında yok

#Projenin istediği Node sürümü derleme ortamında yok

#Node sürümü üst sınırsız istenmiş

#Python sürümü projeden seçilir

#Başlatma

Derleme bitti ama uygulama başlatılamadı. Başlatma komutunu ortamın Ayarlar › Derleme ve çalıştırma bölümünden denetleyin.

#Başlatma betiği bir geliştirme sunucusu

#Turguz'un seçtiği başlatma komutu sunucuyu açmadı

#Uygulamanın nasıl başlatılacağı belirlenemedi

#Başlatma komutu bir dosya adı, yorumlayıcısı yok

#Başlatma komutu bulunamadı

#Uygulamanın başlattığı nginx açılmadı

#Çalışırken

Uygulama başladı ama çalışırken düştü: yanlış kapı, yetmeyen bellek, yazılamayan dosya ya da eksik kütüphane. Uygulamanın PORT değişkenini ve 0.0.0.0 adresini dinlediğinden emin olun (Port ve adres); bellek yetmiyorsa ortam boyunu büyütün.

#Uygulama bir klasöre yazamadı

#Uygulama başka bir portu dinliyor

#Uygulama yalnız kendi içinden erişilen adreste dinliyor

#Uygulama portu açmadı

#Başlatma dosyası çalıştırılamıyor

#Erlang uygulaması açılışta bağlantı tablosu için bellek ayıramadı

#Bellek yetmedi

Uygulama durdu: bellek yetmedi, ortamın bellek sınırını aştı. Ortamın boyunu büyütün ya da uygulamanın bellek kullanımını azaltın.

#Play sunucusu PID dosyasız ve ortamın portunda açılır

#JVM belleği açılışta kabın boyuna göre hesaplanır

#Tarayıcının kum havuzu başlamadı

#Çalışma ortamında tarayıcı yok

#Tarayıcı açılırken durdu

#Uygulamanın dosyaları geçici diske sığmadı

#Geçici disk hazırlanamadı

Uygulama açılmadı: dosyaları geçici diske kopyalanamadı, sebebi aşağıdaki ayrıntıda. Yeniden dağıtın; sürerse platform yöneticisine haber verin.

#Kalıcı disk hazırlanamadı

Yayın durdu, çalışan sürüm değişmedi: kalıcı disk hazırlanamadı, platformun hazırlık aracı yüklenemedi. Platform yöneticisine haber verin.

#Kalıcı klasörün yolunda sembolik bağ var

#Kalıcı yapılan yol derlenen uygulamada bir dosya

#Kalıcı klasörün üst klasörü derlenen uygulamada yok

#Kalıcı disk doldu

Uygulama yazamadı: kalıcı disk doldu. Kalıcı diski büyütün ya da diskteki gereksiz dosyaları silin.

#Uygulama kalıcı diske yazamadı

Uygulama kalıcı diske yazamadı: izni yok. Uygulama açılışta kullanıcısını değiştiriyorsa baştan aynı kullanıcıyla çalıştırın; değiştirmiyorsa platform yöneticisine başvurun.

#Uygulamanın geçici alanı doldu

Uygulama durduruldu, yazdığı dosyalar silindi: geçici alanı doldu. Kalıcı olması gerekenler için kalıcı disk açın; geçici dosyaları temizleyin ya da uygulamanın geçici diskini büyütün.

#Uygulama yazılamayan bir yola yazmak istedi

#Geçici disk doldu

Uygulama yazamadı: geçici diski doldu. Uygulamanın geçici diskini büyütün ya da yazdığı dosyaları azaltın.

#Çalışma ortamında bir sistem kütüphanesi yok

#Port zaten kullanımda

Uygulama açılmadı: dinlemek istediği port zaten kullanımda. Portu tek bir süreç açsın; uygulamayı PORT değişkenindeki portu dinleyecek biçimde başlatın.

#Dosya izni yetersiz

Uygulama bir dosyaya ya da klasöre yazamadı: izni yok. Yola ayrıntıdan bakın; dosyaları /tmp altına ya da kalıcı diske yazdırın.

#Dosya ya da klasör bulunamadı

Uygulama beklediği bir dosyayı ya da klasörü bulamadı. Yola ayrıntıdan bakın; dosyayı depoya ekleyin ya da yolu düzeltin.

#Komut uygulamada olmayan bir paket betiğini çağırıyor

#Statik site

Statik sitenin derleme çıktısı bulunamadı ya da klasörü yanlış. Özet hangi klasörün beklendiğini söyler.

#Yayınlanacak derleme çıktısı bulunamadı

#Elle verilen statik klasör kullanılamıyor (yok, index.html yok ya da depo dışı)

#Statik sitenin kökündeki araç dosyası başka bir dil seçtirebilir

Site açılmadı: derlenen uygulamada Node yok, proje başka bir dille derlenmiş (ör. kökteki Rakefile yüzünden Ruby). Yeniden derleyin; Turguz derlemeyi artık Node'a sabitliyor. Başlatma komutunu kendiniz yazdıysanız projenin diline uygun bir komut yazın.

#Veritabanı ve yan hizmetler

Uygulama veritabanına ya da bir yan hizmete bağlanamadı. Ortamın Veritabanı sekmesini denetleyin (Veritabanı).

#Derleme veritabanına ulaşamadı; derlemeye kapalı

Derleme veritabanına ulaşamadı: bu ortamın veritabanı derlemeye kapalı. Sayfalar derlemede veritabanından üretiliyorsa Ayarlar › Derleme ve çalıştırma'da «Derlemede veritabanı»nı açıp yeniden derleyin.

#Derleme veritabanında aradığı tabloyu bulamadı

#Derleme veritabanına yazmaya çalıştı

#Derleme veritabanında derlemeye ayrılan bağlantı sınırını aştı

Derleme durdu, yeni sürüm yayına alınmadı: derleme veritabanına kendisine ayrılandan fazla bağlantı açtı. Yeniden derleyin. Tekrar ederse next.config dosyasındaki experimental.cpus ayarını ya da kodunuzda veritabanı bağlantı havuzunu büyüten ayarı kaldırın; böyle bir ayar yoksa ortamı daha büyük bir veritabanı sunucusuna bağlayın.

#Uygulama veritabanı adresini JDBC biçiminde bekliyor

#Uygulama veritabanı adresini async sürücü biçiminde bekliyor

#Uygulama ek bağlantıları için ayrı veritabanları istiyor

#Ecto göçü uygulamanın içinde, bağlantı payı yetmiyor

#Veritabanına şifreli bağlantı istendi

#Veritabanı bağlantı sınırı doldu

#Veritabanı dosyası açılamadı

Uygulama SQLite veritabanı dosyasını açamadı: dosyanın klasörü yok ya da yazılamıyor. Kalıcı disk açın ve dosyanın yerini diskin altına verin: /data/db.sqlite3.

#Uygulama veritabanı türünü bir değişkenden seçiyor

#Bağlantı adresi Compose'tan kalma bir ad

#Uygulamanın istediği veritabanı eklentisi yönetilen veritabanında yok

#İnternet ve dış servisler

Uygulama ya da derleme internete çıkmaya çalıştı. Ortamlar varsayılan olarak internete kapalıdır; gerekiyorsa internet erişimi isteyin.

#Yazı tipi derlemede Google'dan indirilemedi

#İnternetteki bir adrese ulaşılamadı

#Uygulama bir servise bağlanamadı

Uygulama bir servise bağlanamadı: veritabanı ya da API bu ortamda yok veya adresi yanlış. Adresi veren değişkeni kontrol edin; veritabanıysa ortama veritabanı bağlayın.

#Değişkenler ve ayarlar

Eksik ya da yanlış bir ortam değişkeni ya da ayar (Değişkenler).

#Uygulama açılışta bir değişkeni bulamadı

#Django sitenin adresine cevap vermiyor

#Platform

Sorun projenizde değil, platformun bir parçasında. Biraz sonra yeniden deneyin; sürerse platform yöneticinize haber verin.

#Beklenmeyen bir hata, işlem yarım kaldı

Beklenmeyen bir hata oldu, işlem yarım kaldı — yeniden deneyin.

#Derleme sırası açılmadı

#Paket aynası yanıt vermiyor

Bağımlılıklar kurulamadı: paket aynası yanıt vermiyor ve bu sitenin interneti yok. Biraz sonra yeniden dağıtın; sürerse platform yöneticinize bildirin.

#Dağıtım yarıda kaldı, platform kaydı kapattı

#Derlenen sürüm kaydedilemedi

#Derleme hazırlığı yarım kaldı

#Bir dış depo istek sınırına takıldı

#Kaynak kod derleme ortamına aktarılamadı

Kaynak kod derleme ortamına aktarılamadı: platformun iç ağında geçici bir sorun oldu, kodunuzla ilgisi yok. Aynı dosyayı yeniden yükleyin ya da yeniden dağıtın; sürerse platform yöneticisine haber verin.

#Platformun derleme ortamı eksik

Derleme başlamadı: platformun derleme ortamı eksik, kodunuzla ilgisi yok. Yönetici bilgilendirildi; düzeltildiğinde yeniden dağıtın.

#Bu kurulumda PHP derlemesi açık değil

#Derleme dışarıya çok veri gönderdiği için durduruldu

#Kaynak kod için depo erişimi yenilenemedi ya da reddedildi

#Kod deposuna ulaşılamadı

Derleme başlamadı: kod deposuna ulaşılamadı. Yeniden dağıtın; sürerse projenin depo bağlantısını kontrol edin ya da platform yöneticisine haber verin.

#Ağ hazırlığı tamamlanmadı, uygulama başlatılmadı

Uygulama başlamadı: platformun ağ hazırlığı tamamlanmadı. Yeniden dağıtın; sürerse platform yöneticisine haber verin.

#Geçici disk bağlanamadı

Yayın durdu, çalışan sürüm değişmedi: uygulamanın geçici diski bağlanamadı. Platform yöneticisine haber verin; sebep disk alanında ya da depolama ayarındadır.