Yazı Boyutu:

Sorun:

cPanel veya WHM üzerinden Node.js Selector çalıştırmak istediğinizde şu hatayı alabilirsiniz:

“Apache Passenger is required by Node.js Selector. Please, contact your hoster.”

Bu hata, Node.js Selector’ın arka planda Phusion Passenger (mod_passenger) modülüne ihtiyaç duymasından kaynaklanır. Passenger yüklü değilse, Node.js uygulamaları başlatılamaz.


✅ Çözüm: mod-alt-passenger Kurulumu (WHM - EasyApache 4)

Gerekli Gereksinimler:

  • WHM (Web Host Manager) root erişimi

  • CloudLinux (çünkü Node.js Selector ve mod-alt-passenger CloudLinux ile uyumlu)


Adım Adım Kurulum

1. WHM’ye Giriş Yapın

Tarayıcınızdan:

https://sunucu-ip-adresi:2087

adresine gidin ve root bilgileriyle giriş yapın.


2. EasyApache 4'e Girin

Sol menüde arama kutusuna EasyApache 4 yazın ve çıkan seçeneğe tıklayın.


3. Apache Modüllerini Özelleştirin

Açılan ekranda:

  • Currently Installed Packages” altında “Customize” butonuna tıklayın.

  • Üst menüde Apache Modules sekmesine geçin.


4. Passenger Modülünü Ekleyin

Arama kutusuna şu anahtar kelimeyi yazın:

mod-alt-passenger

Çıkan satırda şu bilgiyi görmelisiniz:

mod-alt-passenger 5.3.7-13.el8.cloudlinux
Açıklama: Phusion Passenger apache2 module

  • Sağda bulunan Install butonuna tıklayın.


5. Provision İşlemini Başlatın

Değişiklikleri yaptıktan sonra:

  • Üst menüde Review sekmesine geçin.

  • Sayfanın en altında bulunan Provision butonuna tıklayarak kurulumu başlatın.

Bu işlem birkaç dakika sürecektir.


6. Apache Servisini Yeniden Başlatın (Gerekirse)

WHM ana sayfasında:

  • Sol menüden Restart Services > HTTP Server (Apache) adımlarını izleyin.

  • “Yes” diyerek Apache’yi yeniden başlatın.


7. Node.js & Python Selector'ı Yeniden Deneyin

cPanel üzerinden veya CloudLinux’un Node.js Selector panelinden Node.js uygulamanızı başlatmayı deneyin. Artık sorunsuz şekilde çalışması gerekir.

Sıkça Sorulanlar

mod_passenger yerine mod-alt-passenger ne farkı var?

  • mod-alt-passenger, CloudLinux için optimize edilmiş versiyondur.

  • Node.js Selector ile tam uyumlu çalışır.

Passenger kurulu ama hâlâ çalışmıyor, neden?

  • Apache yeniden başlatılmamış olabilir.

  • Passenger log’larını kontrol edin: /var/log/apache2/error_log

  • Node.js Selector yapılandırması hatalı olabilir (örneğin yol hataları, port çakışmaları).


Sonuç

CloudLinux + WHM kullanan tüm sunucularda Node.js Selector’ın düzgün çalışması için mod-alt-passenger kurulumu şarttır. Yukarıdaki adımlarla dakikalar içinde Node.js desteğini aktif hale getirebilirsiniz.