Node.js Kurulumu ve PM2 ile Process Yönetimi (VPS)

Son doğrulama: Eylül 2026 · Ubuntu 24.04 test sunucusunda denendi

Hızlı çözüm

Node.js PM2 kurulumu Ubuntu VPS’te üç adımda tamamlanır: NodeSource deposundan Node.js’i kurun, npm install -g pm2 ile PM2’yi ekleyin, uygulamanızı pm2 start app.js --name uygulama komutuyla arka planda başlatın. PM2, uygulama çökerse otomatik yeniden başlatır ve sunucu yeniden başlasa bile ayakta kalmasını sağlar.

  1. Node.js’i kurun: NodeSource kurulum betiği + apt-get install nodejs
  2. PM2’yi kurun: npm install -g pm2
  3. Uygulamayı başlatın: pm2 start app.js --name uygulama
  4. Durumu görün: pm2 list
Panel Yok (SSH / terminal)
Sistem Ubuntu 22.04/24.04 (VPS/VDS)
Yetki root ya da sudo
Narhost ürünü VPS Sunucu, VDS Sunucu

Başlamadan önce

  • Sunucunuza root ya da sudo yetkili bir kullanıcıyla SSH ile bağlanabiliyor olmalısınız; ilk kez bağlanıyorsanız önce VPS/VDS ilk kurulum rehberini tamamlayın.
  • Uygulamanızın kaynak kodu sunucuda hazır olmalı (Git ile klonlanmış ya da FTP/SFTP ile yüklenmiş).
  • Uygulamanın dinleyeceği port, güvenlik duvarında ya da bir ters proxy arkasında planlanmış olmalı.
  • Sunucuda daha önce farklı bir Node.js sürümü kuruluysa çakışmayı önlemek için önce onu kaldırın.

Node.js PM2 kurulumu ne işe yarar, ne zaman gerekir

Narhost VPS ve VDS ürünleri yönetimsizdir; işletim sistemi hazır gelir, uygulama çalıştırma ortamını sunucunuzda siz kurarsınız. Bir Node.js uygulamasını (API, gerçek zamanlı servis, küçük bir web uygulaması) terminalden node app.js ile başlatırsanız, SSH oturumunu kapattığınız an uygulama da durur ve bir hata aldığında kendini yeniden başlatmaz. PM2, Node.js için tasarlanmış bir process yöneticisidir; uygulamayı arka planda daemon olarak tutar, çökme durumunda otomatik yeniden başlatır ve tek komutla birden fazla kopyasını (cluster modu) çalıştırabilir.

Node.js PM2 kurulumu bu yüzden tek başına bir “kurulum” değil, uygulamanızı üretim ortamında güvenilir çalıştırmanın standart yoludur; PM2 olmadan çalışan bir Node.js uygulaması, sunucu yeniden başladığında ya da kod bir istisna fırlattığında sessizce durur. PM2’nin süreç yönetimi, log takibi ve cluster modu PM2’nin resmi belgesinde ayrıntılı anlatılır.

Node.js PM2 kurulumu akış şeması — NodeSource ile Node.js kurma, PM2 ekleme, uygulamayı başlatma ve otomatik açılış
Node.js'ten üretime dört adım: depoyu ekle, Node.js'i kur, PM2 ile başlat, otomatik açılışı kaydet.

Node.js PM2 kurulumu adım adım

  1. NodeSource deposunu ekleyin. Ubuntu’nun kendi deposu genelde eski bir Node.js sürümü taşır; güncel bir LTS sürümü için NodeSource kurulum betiğini çalıştırın.
    curl -fsSL https://deb.nodesource.com/setup_lts.x -o /tmp/nodesource_setup.shbash /tmp/nodesource_setup.sh

    Beklenen sonuç: Repository configured successfully. satırı ve “To install Node.js, run: apt install nodejs -y” mesajı. Hangi sürümün güncel LTS olduğunu Node.js’in resmi sürüm takviminden kontrol edebilirsiniz.

  2. Node.js’i kurun.
    apt-get install -y nodejs

    Beklenen sonuç: kurulum biter, node -v test sunucusunda v24.21.0 döndürdü (LTS sürüm numarası zamanla değişir).

  3. PM2’yi npm ile global kurun.
    npm install -g pm2

    Beklenen sonuç: added 77 packages benzeri bir özet; pm2 --version sürüm numarasını gösterir (test sunucusunda 7.0.4).

  4. Uygulamayı PM2 ile başlatın. Uygulama klasörünüze girip giriş dosyanızı PM2’ye verin.
    cd /yol/uygulamapm2 start app.js --name uygulama

    Beklenen sonuç: bir tablo çıkar, status sütununda online yazar. Test sunucusunda örnek bir uygulama aynı komutla saniyeler içinde online durumuna geçti ve curl ile isteğe yanıt verdi.

  5. Sunucu yeniden başladığında otomatik açılmasını sağlayın.
    pm2 startuppm2 save

    Beklenen sonuç: pm2 startup bir systemctl komutu önerir; o komutu çalıştırıp ardından pm2 save ile mevcut süreç listesini kaydedersiniz.

Dikkat

PM2’yi root kullanıcısıyla kurup pm2 startup çalıştırdıysanız otomatik açılış root’a bağlanır. Uygulamayı ayrı bir kullanıcıyla çalıştırmak istiyorsanız pm2 startup komutunu o kullanıcı altında tekrar çalıştırın.

Doğrulama

Sonuç

pm2 list komutunda uygulamanızın status sütunu online görünüyorsa ve curl http://127.0.0.1:PORT ile beklenen yanıtı alıyorsanız kurulum tamamlanmıştır. Test sunucusunda örnek bir HTTP uygulaması bu şekilde doğrulandı; pm2 show uygulama komutu çalışma süresini, log dosyası yollarını ve yeniden başlama sayısını ayrıca gösterir.

Hâlâ çözülmediyse

  • Uygulama “online” görünüyor ama yanıt vermiyor. Uygulamanın 0.0.0.0 yerine 127.0.0.1‘e bağlı dinlediğini kontrol edin; dışarıdan erişim gerekiyorsa uygulamanın önüne bir Nginx ters proxy koyun.
  • “npm: command not found” hatası. NodeSource betiği çalışmamış olabilir; ikinci adımı tekrarlayın ve node -v ile kurulumu doğrulayın.
  • Uygulamayı konteynerde çalıştırmak istiyorsanız PM2 yerine Docker ile izole bir süreç yönetimi de tercih edebilirsiniz; ikisi farklı yaklaşımlardır, aynı sunucuda ikisine de gerek yoktur.

Narhost desteği

Kurulum sırasında takılırsanız destek talebinize sunucunuzun işletim sistemi sürümünü, node -v ve pm2 --version çıktısını ve aldığınız tam hata mesajını ekleyin.

Destek talebi aç

Sıkça sorulan sorular

Node.js PM2 kurulumu için Docker’a gerek var mı?

Hayır, ikisi ayrı yaklaşımdır. PM2 tek sunucuda süreç yönetimi sağlar; Docker’ı yalnızca uygulamanızı izole bir konteynerde çalıştırmak istiyorsanız tercih edersiniz.

PM2 kaç uygulamayı aynı anda yönetebilir?

Sunucu kaynağınız yettiği sürece sınır yoktur; her uygulamayı pm2 start ile ayrı bir isimle ekler, pm2 list ile hepsini tek ekrandan izlersiniz.

Sunucu yeniden başlarsa uygulamam otomatik açılır mı?

Yalnızca pm2 startup ve pm2 save komutlarını çalıştırdıysanız. Bu iki komut olmadan PM2 süreçleri yeniden başlatmada kalıcı olmaz.

Bu makale sorununuzu çözdü mü?

Çö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.

Etiketler: nodejspm2

İlgili çözümler