# 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](#hata-ozetleri) 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](/docs/tr/proje-yayinlama#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](/docs/tr/internet-erisimi).
- 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](/docs/tr/proje-yayinlama#site-acilirken-ve-kapaliyken).

## 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](/docs/tr/internet-erisimi).

## Kota yetmiyor

Kota yetmeyen işlem yapılmaz. Ne yapacağınız: [Kota yetmezse](/docs/tr/kota-ve-kullanim#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](/docs/tr/sanal-sunucu#baglanmak).

## 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](/docs/tr/proje-yayinlama#hazirlik-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](/docs/tr/proje-yayinlama#port-ve-adres)); bellek yetmiyorsa [ortam boyunu](/docs/tr/ortamlar#ortam-boyu) 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ı](/docs/tr/veritabani)).

#### 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](/docs/tr/internet-erisimi) 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](/docs/tr/ortamlar#degiskenler)).

#### 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.

#### Veritabanı kullanıcı adı ayrılmış bir önekle başlıyor
