WHM Üzerinden Node.js Selector İçin Apache Passenger (mod-alt-passenger) Kurulumu
İçindekiler
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:
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:
Çı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.