Cara Install Nodejs di Hosting cPanel: Panduan Lengkap untuk Pemula

Node.js makin banyak dipakai. Bukan tanpa alasan, framework seperti Express.js, Nuxt.js, sampai Next.js semuanya butuh Node.js sebagai fondasinya. Kalau kamu sedang membangun API backend atau aplikasi real-time, Node.js kemungkinan besar masuk daftar requirement proyekmu.

Pertanyaan yang sering muncul: apakah bisa install Nodejs di hosting biasa, atau harus pakai VPS dulu? Jawabannya tergantung paket hostingnya. Di hosting berbasis cPanel seperti DomaiNesia, proses install Nodejs di hosting bisa dilakukan langsung dari cPanel, tanpa perlu konfigurasi server manual, tanpa akses root.

Artikel ini membahas cara install Nodejs di hosting cPanel dari awal sampai selesai. Mulai dari memilih versi yang tepat, menjalankan Node.js via terminal cPanel, install package lewat NPM, sampai membuat dan menjalankan aplikasi pertamamu. Kalau kamu baru pertama kali mencoba, ikuti langkah demi langkah, semuanya bisa dilakukan dari browser.

Apa Itu Node.js dan Kegunaannya di Hosting?

Node.js adalah runtime JavaScript yang berjalan di sisi server (server-side). Sederhananya: kode JavaScript yang biasanya hanya bisa dieksekusi di browser, dengan Node.js bisa dijalankan langsung di server untuk memproses request, mengakses database, atau menangani logika aplikasi.

Yang membedakan Node.js dari PHP atau bahasa server-side lain adalah cara kerjanya yang non-blocking. Node.js tidak menunggu satu proses selesai sebelum menangani request berikutnya. Untuk aplikasi yang menerima banyak koneksi bersamaan, misalnya chat atau notifikasi live, ini punya dampak nyata pada kecepatan respons.

Di hosting cPanel, Node.js berguna untuk beberapa skenario ini:

• API backend – membangun REST API atau GraphQL endpoint yang dikonsumsi aplikasi mobile atau web frontend
• Aplikasi real-time – chat, notifikasi live, atau dashboard yang datanya terus diperbarui tanpa reload halaman
• Web app berbasis framework – menjalankan Express.js, Nuxt.js, Next.js, atau framework Node.js lainnya langsung di server hosting
• Skrip otomatisasi – menjalankan proses background seperti cron job berbasis JavaScript

Perlu dicatat: Node.js di shared hosting punya batasan resource yang tidak ada di VPS. Untuk proyek kecil sampai menengah, hosting cPanel sudah cukup. Tapi kalau aplikasimu mulai butuh konfigurasi server yang lebih bebas, pertimbangan upgrade ke VPS akan relevan, ini akan dibahas di bagian akhir artikel.

Syarat Sebelum Install Nodejs di Hosting

Sebelum mulai proses instal Nodejs di hosting, ada tiga hal yang perlu disiapkan sebagai berikut:

• Paket hosting yang mendukung Node.js – tidak semua paket hosting support Node.js. Di DomaiNesia, fitur ini tersedia mulai Nimbus Go dan Nimbus Plus. Cek paket aktifmu di MyDomaiNesia, kalau masih Nimbus One, ikuti dulu cara upgrade layanan hosting sebelum lanjut ke langkah instalasi.
• Akses cPanel aktif – seluruh proses install Nodejs di hosting dilakukan lewat cPanel, dari memilih versi Node.js, menjalankan terminal, sampai membuat aplikasi. Kalau belum pernah masuk cPanel sebelumnya, bisa langsung akses cPanel dari MyDomaiNesiamu atau ikuti dulu panduan login cPanel sebelum lanjut.
• Koneksi internet stabil – proses instalasi Node.js butuh waktu 3-5 menit. Koneksi yang terputus di tengah proses bisa menyebabkan instalasi tidak selesai atau error saat pertama kali dijalankan. Pastikan koneksi stabil sebelum klik tombol Install.

Cara Install Nodejs di Hosting cPanel

Proses install Nodejs di hosting cPanel DomaiNesia tidak butuh banyak langkah. Semua dilakukan lewat dashboard, tidak perlu SSH, tidak perlu command line dulu di tahap ini.

1. Login ke cPanel

Masuk ke cPanel hosting kamu. Kalau biasanya akses lewat MyDomaiNesia, pilih menu My Services klik untuk kelola hosting lalu klik Login to cPanel. Kalau belum hafal caranya, ikuti panduan login cPanel.

2. Buka Menu Node.js

Setelah masuk dashboard cPanel, ketik “nodejs” di kolom pencarian. Klik menu Nodejs yang muncul di hasil pencarian.

Tampilannya menunjukkan daftar versi Node.js yang tersedia untuk diinstall. Kalau menu ini tidak muncul, kemungkinan besar paket hostingmu belum support, cek kembali syarat di bagian sebelumnya.

3. Pilih Versi Node.js dan Klik Install

Di sinilah satu keputusan kecil yang cukup berpengaruh: pilih versi Node.js yang tepat.

Ada dua jenis versi yang biasanya tersedia:

• LTS (Long Term Support) – versi stabil yang dapat dukungan perbaikan bug dan keamanan lebih lama. Untuk proyek production atau kalau kamu tidak yakin mau pakai versi berapa, pilih ini.
• Current – versi terbaru dengan fitur paling baru, tapi belum tentu semua package mendukungnya. Cocok kalau kamu butuh fitur spesifik dari versi terbaru.

Untuk sebagian besar kasus, pilih versi LTS. Setelah memilih versi, klik tombol Install di sebelah kanan.

4. Tunggu Proses Instalasi Selesai

Proses install Nodejs di hosting butuh waktu sekitar 3-5 menit. Jangan tutup tab browser selama proses berjalan.

Tanda instalasi berhasil: tombol Install berubah jadi Uninstall. Itu artinya Node.js sudah aktif di hosting kamu dan siap digunakan.

Kalau setelah 10 menit tombolnya tidak berubah atau muncul pesan error, coba refresh halaman. Kalau masih gagal, kemungkinan ada konflik resource, tunggu beberapa menit lalu ulangi prosesnya.

Cara Menjalankan Node.js di Hosting

Node.js sudah terinstall. Tapi belum bisa langsung dipakai begitu saja, ada satu langkah yang perlu dilakukan dulu supaya sistem hosting mengenali versi Node.js yang baru diinstall. Langkah ini cukup singkat, tapi sering dilewati dan jadi penyebab error pertama yang dialami pemula.

1. Salin Command Environment dari Panel Node.js

Kembali ke halaman Nodejs di cPanel. Di sana ada satu baris command yang perlu disalin, biasanya terlihat seperti ini:

Command ini memberitahu sistem untuk memuat konfigurasi environment Node.js yang baru diinstall. Tanpa menjalankan perintah ini, terminal hosting belum “tahu” bahwa Node.js sudah ada.

Salin command tersebut. Jangan diketik manual, salin langsung dari panel supaya tidak ada karakter yang terlewat.

2. Buka Terminal di cPanel

Ketik “terminal” di kolom pencarian cPanel. Klik menu Terminal yang muncul.

Terminal cPanel adalah akses command line langsung ke server hostingmu, tanpa perlu software tambahan seperti PuTTy atau aplikasi SSH. Kalau kamu pengguna Windows yang biasa pakai PuTTy, terminal ini cara yang lebih praktis untuk sesi singkat. Untuk akses SSH yang lebih lengkap, ikuti cara akses SSH di cPanel hosting.

3. Jalankan Command dan Tekan Enter

Paste command yang tadi disalin ke dalam terminal. Tekan Enter.

Tidak akan ada output yang dramatis. Kalau berhasil, cursor berpindah ke baris baru tanpa pesan error. Itu normal, artinya environment sudah dimuat.

4. Cek Versi Node.js

Verifikasi bahwa proses install Nodejs di hosting sudah berhasil dengan menjalankan command berikut:

Kalau muncul nomor versi yang sesuai dengan yang kamu install tadi, misalnya v20.11.0 untuk Node.js 20 LTS, berarti semuanya berjalan dengan benar. Cek juga versi NPM (Node Package Manager, pengelola package bawaan Node.js):

Keduanya harus menampilkan versi, bukan pesan error. Kalau salah satu tidak muncul, kemungkinan command source ~/.bash_profile belum dijalankan, ulangi dari langkah 1.

Cara Install Package Node.js dengan NPM

NPM sudah otomatis terinstall bersamaan dengan Node.js. Fungsinya: mengelola package atau library tambahan yang dibutuhkan aplikasimu. Hampir semua proyek Node.js pasti butuh setidaknya satu package dari NPM.

Cara pakainya cukup langsung. Misalnya kamu butuh Express.js, framework web paling populer di ekosistem Node.js:

Atau kalau proyekmu pakai Yarn sebagai package manager alternatif:

Setelah instalasi selesai, cek package apa saja yang sudah terinstall:

Outputnya menampilkan daftar package beserta versinya. Kalau package yang baru diinstall muncul di sini, instalasi berhasil.

Satu hal yang perlu diingat saat install package di hosting: setiap package yang diinstall menggunakan storage dan memori hosting. Untuk package yang dibutuhkan di production saja, gunakan flag --save. Untuk package yang hanya dipakai saat development, gunakan --save-dev supaya tidak ikut terbawa ke environment production.

Butuh panduan lebih lanjut soal Express.js? Ini dia cara install Express.js di hosting.

Cara Membuat dan Menjalankan Aplikasi Node.js di Hosting

Kalau tadi kita hanya menginstall Node.js sebagai runtime, sekarang saatnya membuat “wadah” untuk aplikasinya. Di cPanel, ini dilakukan lewat menu Setup Node.js App, fitur yang memungkinkan kamu mengkonfigurasi dan menjalankan aplikasi Node.js langsung dari dashboard tanpa perlu mengatur semuanya manual via SSH.

1. Buka Menu Setup Node.js App

Ketik “setup nodejs” di kolom pencarian cPanel. Kali ini pilih Setup Node.js App, bukan menu Node.js yang tadi dipakai untuk instalasi. Keduanya berbeda: menu Node.js untuk install runtime nya, Setup Node.js App untuk mengatur dan menjalankan aplikasinya.

Klik Create Application untuk mulai.

2. Atur Konfigurasi Aplikasi

Ada beberapa field yang perlu diisi:

• Node.js version – pilih versi yang sama dengan yang tadi diinstall. Konsistensi versi di sini penting supaya tidak ada konflik dependency antar package.
• Application mode, ada dua pilihan:
  • Development: menampilkan pesan error secara detail di browser. Pakai ini selama masih pengembangan.
  • Production: menyembunyikan detail error dari pengunjung. Wajib dipakai kalau aplikasi sudah live.

• Application root – folder tempat file aplikasimu disimpan di server. Misalnya myapp atau node-project. Hindari nama folder seperti node, npm, atau public_html, bisa bentrok dengan sistem.
• Application URL – pilih domain atau subdomain mana yang akan menjalankan aplikasi ini. Kalau belum punya subdomain khusus, buat dulu lewat menu Subdomains di cPanel.

Setelah semua diisi, klik Create. Tunggu beberapa detik sampai aplikasi terbuat.

3. Upload File Proyek Node.js

Setelah aplikasi dibuat, masuk ke folder yang tadi ditentukan di Application root lewat File Manager cPanel. Upload semua file proyekmu ke folder tersebut.

Dua hal yang perlu diperhatikan saat upload:

• Pastikan file package.json ikut terupload. File ini berisi daftar semua dependency yang dibutuhkan aplikasimu.
• Folder node_modules tidak perlu diupload. Ukurannya bisa sangat besar dan akan digenerate ulang di server.

Setelah upload selesai, kembali ke Setup Node.js App. Klik tombol Run NPM Install, ini akan menginstall semua package yang terdaftar di package.json langsung di server hostingmu. Prosesnya mirip dengan menjalankan npm install manual di terminal, tapi lebih mudah karena cukup satu klik.

Sudah sampai di tahap ini artinya Node.js mu sudah jalan di hosting. Kalau kamu belum punya hosting yang support Node.js dan masih mencari, paket Nimbus Go atau Nimbus Plus DomaiNesia sudah include fitur ini sejak awal, tidak perlu konfigurasi tambahan. 

Lihat Paket Hosting DomaiNesia

4. Jalankan Aplikasi

Setelah proses NPM Install selesai, silakan akses menu Setup Node.js App pada cPanel lalu pastikan aplikasi dalam status started atau nyala hijau.

Apabila terdapat perubahan pada source code atau dependency, silakan lakukan:

• Stop App
• lalu Start/Restart App kembali dari menu Node.js App

Pastikan juga file startup aplikasi sudah sesuai, misalnya:

• app.js
• index.js
• server.js

sesuai struktur project yang digunakan.

Catatan: Pada environment cPanel Node.js App, aplikasi umumnya dijalankan otomatis oleh Passenger/App Manager, sehingga tidak perlu menjalankan manual menggunakan command:

node app.js

karena dapat menyebabkan konflik process atau error port already in use (EADDRINUSE).

Akses domain atau subdomain yang tadi dikonfigurasi di browser. Kalau aplikasi muncul, proses install Nodejs di hosting sampai deploy sudah selesai sepenuhnya.

Tips Menggunakan Node.js di Hosting

Beberapa hal kecil yang sering diabaikan tapi cukup berpengaruh saat menggunakan Node.js di shared hosting.

Selalu Pakai Versi LTS

Versi LTS (Long Term Support) mendapat perbaikan bug dan patch keamanan lebih lama dibanding versi Current. Untuk production, ini bukan pilihan opsional, ini standar yang perlu dijaga. Cek versi LTS terbaru di https://nodejs.org/en/download sebelum memilih versi saat install.

Sesuaikan Application Mode dengan Kondisi

Banyak developer lupa mengganti mode dari Development ke Production sebelum aplikasi live. Di mode Development, pesan error yang muncul di browser bisa mengekspos struktur folder, nama file, bahkan sebagian kode aplikasimu ke pengunjung. Ganti mode ini sebelum domain aktif diakses publik.

Pantau Penggunaan Resource

Node.js di shared hosting berbagi resource dengan pengguna lain di server yang sama. Aplikasi yang terlalu banyak memakai memori atau CPU bisa dimatikan otomatis oleh sistem. Kalau aplikasimu mulai lambat atau sering restart sendiri, itu sinyal bahwa resource hosting sudah tidak cukup.

Gunakan PM2 untuk Production

PM2 adalah process manager untuk Node.js yang menjaga aplikasi tetap berjalan meski terjadi error atau server restart. Di shared hosting, penggunaan PM2 punya keterbatasan dibanding di VPS, tapi tetap bisa dipakai untuk menjaga stabilitas aplikasi sederhana. Panduan lengkapnya ada di cara setting NodeJS dengan PM2.

Kendala Umum dan Solusinya

Proses install Nodejs di hosting cPanel umumnya berjalan lancar. Tapi ada beberapa kendala yang cukup sering muncul, terutama untuk pengguna pertama kali.

Node.js Tidak Muncul di cPanel

Kamu sudah login ke cPanel tapi menu Node.js tidak ketemu di pencarian. Dua kemungkinan penyebabnya:

• Paket hostingmu belum support Node.js – cek di MyDomaiNesia, pastikan paket aktifmu Nimbus Go atau Nimbus Plus
• cPanel sedang dalam proses update – coba logout lalu login kembali, atau tunggu beberapa menit

Kalau setelah dicek paket sudah benar tapi menu tetap tidak muncul, hubungi support DomaiNesia lewat live chat untuk konfirmasi dari sisi server.

Command Tidak Dikenali di Terminal

Kamu sudah masuk terminal dan mencoba node -v, tapi muncul pesan seperti:

Ini hampir selalu karena command source ~/.bash_profile belum dijalankan. Kembali ke halaman Node.js di cPanel, salin ulang command environment-nya, paste di terminal, tekan Enter, lalu coba node -v lagi.

Aplikasi Tidak Bisa Diakses Lewat Browser

Node.js sudah jalan di terminal, tapi saat domain diakses di browser hanya muncul halaman kosong atau error 503.

Cek dua hal ini dulu:

• Application URL di Setup Node.js App – pastikan sudah mengarah ke domain atau subdomain yang benar
• Port aplikasi – Node.js defaultnya jalan di port tertentu. Di shared hosting, port ini diatur otomatis oleh cPanel. Kalau kamu mendefinisikan port manual di kode aplikasi, pastikan sesuai dengan yang dikonfigurasi di Setup Node.js App

Error Permission saat Install Package

Muncul pesan EACCES atau permission denied saat menjalankan npm install. Ini biasanya terjadi karena npm mencoba menulis ke folder yang tidak punya izin akses.

Solusinya: pastikan kamu menjalankan npm install dari dalam folder aplikasi yang sudah dibuat lewat Setup Node.js App, bukan dari direktori lain. Kalau masih muncul, coba jalankan lewat terminal dengan path yang eksplisit ke folder aplikasimu.

Kapan Harus Pakai VPS untuk Node.js?

Shared hosting cukup untuk banyak kasus. Tapi ada titik tertentu di mana pindah ke VPS bukan sekadar opsi, tapi keputusan yang lebih masuk akal. Selama aplikasimu masih masuk kategori ini, shared hosting sudah cukup:

• Proyek personal atau portofolio
• API sederhana dengan traffic rendah
• Aplikasi yang masih dalam tahap development atau testing
• Web app berbasis Express.js dengan jumlah pengguna terbatas

Tapi kalau kondisinya sudah bergeser ke sini, pertimbangkan VPS:

• Aplikasi mulai sering restart sendiri atau lambat di jam-jam tertentu, tanda resource hosting tidak lagi cukup
• Kamu butuh install software tambahan di level sistem operasi yang tidak bisa dilakukan di shared hosting
• Aplikasimu butuh konfigurasi Nginx atau reverse proxy secara manual
• Traffic sudah konsisten tinggi dan butuh skalabilitas yang lebih fleksibel

Di VPS, kamu bebas install Node.js versi berapa saja, jalankan PM2 tanpa batasan, atur firewall sendiri, dan tidak berbagi resource dengan pengguna lain. Tradeoff-nya: kamu perlu lebih familiar dengan manajemen server. Kalau sudah siap ke sana, deploy aplikasi Node.js di Ubuntu dengan PM2 dan Nginx bisa jadi panduan pertama yang relevan.

Belum siap kelola server sendiri tapi butuh resource lebih? Cloud VPS DomaiNesia bisa jadi pilihan tengah, lebih fleksibel dari shared hosting, dengan panel pengelolaan yang tidak jauh berbeda dari yang sudah kamu pakai sekarang. 

Kesimpulan

Install Nodejs di hosting cPanel tidak membutuhkan pengetahuan server yang dalam. Dengan paket Nimbus Go atau Nimbus Plus DomaiNesia, seluruh prosesnya bisa selesai dalam satu sesi, dari install, jalankan di terminal, sampai deploy aplikasi pertama.

Untuk proyek yang masih berkembang, shared hosting sudah lebih dari cukup. Kalau suatu saat aplikasimu butuh lebih banyak ruang, baik dari sisi resource maupun fleksibilitas konfigurasi, upgrade ke VPS bisa dilakukan tanpa harus mulai dari nol.