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.