Bikin bot & app hidup 24 jam dengan PM2

Saat kamu menjalankan node index.jslewat SSH, proses itu "menempel" pada sesi terminalmu. Begitu kamu logout atau koneksi putus, prosesnya ikut mati — bot pun offline. Dan kalau server reboot, tidak ada yang menyalakannya kembali.

PM2 bertindak seperti penjaga setia: ia menjalankan appmu di latar belakang, mengawasinya, dan langsung menghidupkannya lagi kalau crash atau setelah reboot. Bandingkan dua dunia ini:

Cukup tiga hal:

• VPS dengan akses sudo (Ubuntu/Debian).
• Node.js & npm sudah terpasang (cek: node -v dan npm -v).
• Aplikasi/bot yang bisa dijalankan manual, mis. node index.js atau npm start.

Masuk ke server lewat SSH, lalu pasang PM2 secara global memakai npm:

# DI SERVER — pasang PM2 secara global
sudo npm install -g pm2
 
# cek versinya
pm2 --version

deploy@server:~$ pm2 --version5.4.2# PM2 siap dipakai ✅

Masuk ke folder project-mu, lalu jalankan lewat PM2. Beri --name agar mudah dikenali. Pilih cara yang sesuai dengan tipe app-mu:

# Cara cepat: jalankan langsung satu file
pm2 start index.js --name bot-telegram
 
# Untuk app Next.js (script "start" di package.json)
pm2 start npm --name blog -- start
 
# Lihat daftar proses yang dikelola PM2
pm2 list

Cek hasilnya dengan pm2 list. Kolom status harus online:

deploy@server:~$ pm2 list┌────┬──────────────┬─────────┬─────────┐│ id │ name         │ status  │ cpu     │├────┼──────────────┼─────────┼─────────┤│ 0  │ bot-telegram │ online  │ 0%      │└────┴──────────────┴─────────┴─────────┘# status online = app berjalan ✅

Daripada mengetik opsi panjang tiap kali, simpan pengaturan dalam satu file ecosystem.config.js di folder project. Di sini kamu bisa atur batas RAM, variabel lingkungan, dan auto-restart:

1module.exports = {2  apps: [3    {4      name: 'bot-telegram',5      script: './index.js',6      instances: 1,7      autorestart: true,          // nyala lagi kalau crash8      watch: false,               // true = restart saat file berubah9      max_memory_restart: '300M', // restart kalau RAM > 300MB10      env: {11        NODE_ENV: 'production',12      },13    },14  ],15}

Teks lengkap yang bisa kamu salin:

// ecosystem.config.js  — taruh di folder project
module.exports = {
  apps: [
    {
      name: 'bot-telegram',
      script: './index.js',
      instances: 1,
      autorestart: true,          // nyala lagi kalau crash
      watch: false,               // true = restart saat file berubah
      max_memory_restart: '300M', // restart kalau RAM > 300MB
      env: {
        NODE_ENV: 'production',
        // TELEGRAM_TOKEN: 'isi-di-sini-atau-pakai-.env',
      },
    },
  ],
}

Lalu jalankan semuanya hanya dengan satu perintah:

# Jalankan semua app yang didefinisikan di ecosystem.config.js
pm2 start ecosystem.config.js
 
# Simpan daftar proses saat ini supaya bisa dipulihkan otomatis
pm2 save

Ini langkah paling penting agar app benar-benar hidup 24 jam. Tanpa ini, setiap server reboot semua app akan mati. Jalankan:

# 1) Bikin PM2 jalan otomatis tiap server reboot
pm2 startup
 
# Perintah ini akan MENAMPILKAN satu baris perintah "sudo env ..."
# COPY baris yang ditampilkan itu, lalu jalankan.
 
# 2) Setelah app jalan seperti yang kamu mau, kunci daftarnya:
pm2 save

Alur sederhananya seperti ini — tiga "rem pengaman" agar app selalu kembali hidup:

Kalau bot bertingkah aneh, log adalah tempat pertama untuk mencari tahu sebabnya. PM2 menyimpan semua output app-mu:

deploy@server:~$ pm2 logs bot-telegram[bot-telegram] Bot started, polling...[bot-telegram] Pesan masuk dari @andi# Ctrl+C untuk keluar dari tampilan log

Untuk pantauan langsung RAM, CPU, dan jumlah restart tiap app, pakai dashboard bawaan PM2:

deploy@server:~$ pm2 monitbot-telegram   CPU: 0%   MEM: 48.2 MB   ↺ 0# dashboard live di terminal

Simpan tabel ini. Inilah perintah yang akan kamu pakai sehari-hari (ganti bot-telegram dengan nama app-mu):

Kalau ada yang belum jalan, cek tabel ini dulu sebelum panik: