Son doğrulama: Kasım 2026 · Narhost test cPanel hesabında panel özellikleri kontrol edildi
Hızlı çözüm
Node.js uygulaması hostinge nasıl yüklenir sorusunun Narhost için kısa yanıtı: paylaşımlı ve Linux hosting paketlerinde Node.js uygulaması çalıştırılamaz. Node.js uygulaması sürekli ayakta duran bir süreç gerektirir; paylaşımlı pakette bunu sağlayacak panel aracı (Node.js Selector / Application Manager) ve SSH erişimi bulunmaz. Node.js uygulaması için kök erişimi olan bir VPS ya da VDS gerekir.
| Panel | Yok — kurulum SSH üzerinden yapılır |
|---|---|
| Sistem | VPS veya VDS (paylaşımlı / Linux hostingde desteklenmez) |
| Yetki | root ya da sudo |
| Narhost ürünü | VPS Sunucu, VDS Sunucu |
Başlamadan önce
package.json içinde bağımlılıklar ve varsa engines alanı tanımlı olsun.PHP ile Node.js’in sunucuda çalışma biçimi farklıdır. PHP’de her istek için kısa ömürlü bir işlem açılır ve iş bitince kapanır; paylaşımlı hosting tam olarak bu modele göre kurgulanmıştır. Node.js uygulaması ise sürekli ayakta duran, bir portu dinleyen tek bir süreçtir. Bu sürecin başlatılması, çökerse yeniden ayağa kaldırılması ve sunucu yeniden başladığında otomatik açılması gerekir.
Paylaşımlı pakette bunu sağlamanın iki yolu vardır ve Narhost’un paylaşımlı paketlerinde ikisi de kapalıdır:
Dikkat
İnternetteki pek çok rehber “cPanel’de Setup Node.js App aracını açın” diye başlar. Bu araç cPanel’in her kurulumunda bulunmaz; barındırma sağlayıcısının paketinde etkinleştirmesi gerekir. Narhost paylaşımlı paketlerinde etkin değildir, bu yüzden o rehberlerdeki adımlar burada uygulanamaz. cPanel de bu aracın neden bazı hesaplarda görünmediğini kendi destek kaydında açıklıyor.

Uygulamayı yayına almak için kök erişimli bir sunucu ve üç bileşen gerekir:
package.json dosyasındaki engines alanına göre seçersiniz; sunucuda birden fazla sürümü yan yana tutabilirsiniz.Kurulumun komut düzeyinde anlatımı ayrı bir kartta: VPS’te Node.js kurulumu ve PM2 ile süreç yönetimi. Node.js sürümünü sunucuda yönetmek isterseniz nvm ile Node.js kurulumu kartına bakın.
Beklenen sonuç: proje klasöründe package.json içinde bir start betiği ve bir sunucu dosyası (app.js, server.js) varsa kalıcı süreç gerekiyordur.
package.json içindeki engines alanına, yoksa yerelde node -v çıktısına bakın.
Beklenen sonuç: sunucuya kuracağınız sürüm belirlenmiş olur.
Beklenen sonuç: sunucuda tanımlanacak değişkenlerin adı ve değeri hazır olur.
Beklenen sonuç: yedek dosyanız ve kurulacak veritabanı sürümü belli olur.
Beklenen sonuç: geçiş anında kesinti süresi önceden bilinir.
Sonuç
Paylaşımlı paketinizde Node.js desteğinin bulunup bulunmadığını kesin olarak görmek için cPanel’e girip arama kutusuna Node ve ayrıca Application yazın. İki aramada da sonuç çıkmıyorsa pakette Node.js çalıştırılamaz. Bu durumda node.js uygulaması hostinge nasıl yüklenir sorusunun cevabı, kök erişimi olan bir VPS ya da VDS üzerinde kurulum yapmaktır.
Narhost desteği
Uygulamanızın hangi pakette çalışacağından emin değilseniz destek talebinize projenin çatısını (Express, Next.js, NestJS vb.), package.json içeriğini ve kullandığınız veritabanını ekleyin; uygun ürünü birlikte belirleyelim.
Sonraki adımlar
Hayır. Node.js uygulaması sürekli ayakta duran bir süreç gerektirir; paylaşımlı ve Linux hosting paketlerinde bunu sağlayacak panel aracı (Node.js Selector / Application Manager) etkin değildir ve SSH erişimi verilmez. Node.js uygulaması için VPS ya da VDS gerekir.
Bu araç cPanel’in her kurulumunda bulunmaz; CloudLinux Node.js Selector’ın sunucuda kurulu ve pakette etkin olması gerekir. Narhost paylaşımlı paketlerinde etkin değildir, bu yüzden panelde görünmez.
Evet. Derleme sonunda yalnızca HTML, CSS ve JavaScript dosyaları üretiliyorsa bu çıktı paylaşımlı pakette yayımlanabilir; çalışan bir Node.js süreci gerekmez. Sunucu tarafı işlev kullanan projelerde bu yöntem işe yaramaz.
Bir süreç yöneticisi gerekir. PM2 uygulamayı arka planda başlatır, çökerse yeniden kaldırır ve sunucu yeniden başladığında otomatik açar. Kurulum adımları VPS’te Node.js kurulumu ve PM2 kartında anlatılır.
Bu makale sorununuzu çözdü mü?
Geri bildiriminiz için teşekkürler.
Çözemediniz mi?
Teknik ekibimiz sunucu tarafındaki ayarları sizin için kontrol edebilir. Destek talebinizde alan adınızı ve aldığınız hata metnini paylaşmanız süreci hızlandırır.