Hostixo cPanel ile Node.js Uygulaması Yayınlama Rehberi (2025)

Günümüzde web uygulamaları sadece statik HTML sayfalarından ibaret değil. Dinamik yapılar, REST API’ler ve gerçek zamanlı çözümler sunan Node.js, geliştiricilerin gözdesi haline geldi. Bu rehberde, Hostixo altyapısı üzerinden cPanel kullanarak Node.js tabanlı bir web uygulamasını nasıl kuracağınızı, bağımlılıkları nasıl yöneteceğinizi ve yayına nasıl alacağınızı adım adım anlatacağız.

Hostixo cPanel’e Giriş Yapın

İlk adım, Hostixo tarafından sağlanan cPanel hesabınıza giriş yapmaktır. Giriş bilgilerinizi https://www.hostixo.com/panel/login adresi üzerinden yönetebilirsiniz.

• Kullanıcı adı ve şifrenizi unutmanız durumunda müşteri panelinden şifre sıfırlayabilir ya da destek ekibinden yardım alabilirsiniz.

• Giriş yaptıktan sonra cPanel ana ekranında yer alan ikonlar üzerinden işlemlere başlayabilirsiniz.

Node.js Uygulama Dosyalarını Yükleyin

Projenizi sunucuya yüklemek için aşağıdaki adımları takip edin:

1. cPanel > Dosya Yöneticisi (File Manager) bölümüne gidin.

2. Node.js projenizin yüklenmesini istediğiniz dizine geçiş yapın (örneğin app/).

3. “Yükle” butonuna tıklayarak zip haline getirdiğiniz Node.js dosyalarınızı yükleyin.

4. Zip dosyasını sunucuya aktardıktan sonra sağ tıklayıp “Extract” diyerek açın.

5. Varsa varsayılan gelen örnek dosyaları silebilirsiniz.

Not: Projenizi public_html dizini altında değil, onun dışındaki özel bir klasörde barındırmanız önerilir.

Veritabanı Gereksinimleri (Opsiyonel)

Uygulamanız bir veritabanı kullanıyorsa (örneğin: MySQL, MongoDB), bu aşamada gerekli bağlantıları kurmalısınız:

• MySQL kullanıyorsanız, cPanel’de “MySQL Veritabanları” kısmından:

  • Yeni bir veritabanı oluşturun.

  • Kullanıcı tanımlayın ve yetkilendirin.

  • Bağlantı bilgilerini .env dosyanıza eklemeyi unutmayın.

Node.js Uygulaması Oluşturun

Şimdi projenizi aktif hale getirmek için Node.js ayarlarını yapalım:

1. cPanel ana sayfasından Setup Node.js App ikonuna tıklayın.

2. “Create Application” (Yeni Uygulama Oluştur) butonuna basın.

3. Node.js Sürümü: Örneğin 18.x, 20.x veya 22.x seçin.

4. Application Mode:

   • Geliştirme aşamasındaysanız Development,

   • Canlı sistem içinse Production seçin.

5. Application Root: Uygulamanın çalışacağı klasör (örneğin: app)

6. Application URL: Domain veya subdomain seçin (örneğin: node.domain.com)

7. Startup File: Uygulamanın başlangıç dosyası (örneğin: bin/www veya index.js)

Tüm bilgileri doğru şekilde girdikten sonra “Create” butonuna basarak Node.js uygulamanızı oluşturun.

NPM Kurulumu ve Bağımlılıkların Yüklenmesi

Uygulamanızda bağımlılıklar (express, dotenv, mongoose vb.) varsa bunları yüklemek için:

1. “Setup Node.js App” bölümünden uygulamanızın yanındaki “Edit” butonuna tıklayın.

2. Açılan ekranda “Run NPM Install” butonuna tıklayarak package.json dosyanızdaki tüm bağımlılıkları yükleyin.

3. Kurulum birkaç dakika sürebilir. Kurulum tamamlandığında sistem uyarı verecektir.

Ortam Değişkenleri (Environment Variables)

cPanel Node.js uygulama düzenleme ekranında “Environment Variables” (ENV) sekmesini kullanarak örneğin:

• PORT

• DB_CONNECTION

• SECRET_KEY

gibi değişkenlerinizi güvenli şekilde tanımlayabilirsiniz. .env dosyanız varsa, içeriğini buraya da yansıtmanız tavsiye edilir.

Uygulamanızı Yayına Alın ve Test Edin

Tüm adımlar tamamlandıktan sonra tarayıcınızda aşağıdaki gibi URL’ye giderek uygulamanızın çalıştığını test edin:

Eğer uygulamanız açılıyorsa kurulum başarılı demektir. Herhangi bir hata alırsanız:

• Logları inceleyin

• Başlangıç dosyasını ve klasör yolunu kontrol edin

• NPM install sırasında eksik kalan bağımlılıkları gözden geçirin

Sıkça Yapılan Hatalar ve Tavsiyeler

• public_html içinde uygulama oluşturmak → ❌

• Yanlış startup file belirtmek → ❌

• NPM install yapmadan uygulamayı çalıştırmak → ❌

• Port tanımını yapmamak → ❌

✅ Tavsiye: Projelerinizi mutlaka test ortamında denedikten sonra production moduna geçirin.

Neden Hostixo?