{"id":5067,"date":"2025-01-03T08:00:00","date_gmt":"2025-01-03T01:00:00","guid":{"rendered":"https:\/\/www.cloudaja.id\/artikel\/?p=5067"},"modified":"2025-01-17T14:30:31","modified_gmt":"2025-01-17T07:30:31","slug":"mengatasi-error-npm-install-node-js-di-cpanel","status":"publish","type":"post","link":"https:\/\/www.cloudaja.id\/artikel\/mengatasi-error-npm-install-node-js-di-cpanel\/","title":{"rendered":"Mengatasi Error NPM Install Node JS di Hosting cPanel"},"content":{"rendered":"

Node.js adalah salah satu runtime JavaScript populer yang sering digunakan untuk mengembangkan aplikasi modern. Dengan bantuan NPM (Node Package Manager), pengelolaan dependensi aplikasi menjadi lebih mudah. Namun, pada hosting<\/a> cPanel, terkadang pengguna menghadapi error ketika mencoba menjalankan perintahnpm install<\/code>. Salah satu error yang cukup sering muncul adalah terkait dengan folder node_modules<\/code>. Artikel ini akan membahas penyebab error tersebut dan cara mengatasinya.<\/p>\n

\n
\"\"<\/a><\/figure>\n<\/div>\n

Penyebab Error NPM Install di Hosting<\/a> cPanel<\/strong><\/h2>\n

Saat menggunakan hosting<\/a> berbasis cPanel dengan Node.js, salah satu error yang sering muncul terkait instalasi NPM adalah pesan berikut:<\/p>\n

\"\"<\/figure><\/div>\n
\n

“CloudLinux NodeJS Selector demands to store node modules for application in a separate folder (virtual environment) pointed by symlink called node_modules<\/code>. That\u2019s why application should not contain folder\/file with such name in application root.”<\/em><\/p>\n<\/blockquote>\n

Pesan error ini muncul karena CloudLinux NodeJS Selector, yang merupakan fitur pada hosting<\/a> berbasis cPanel untuk mengelola aplikasi Node.js, memiliki aturan khusus dalam penanganan foldernode_modules<\/code>. Dalam lingkungan CloudLinux, NodeJS Selector memerlukan struktur folder yang sesuai dengan sistem virtual environment yang telah ditentukan.<\/p>\n\n

Folder node_modules<\/code> adalah tempat di mana NPM menyimpan semua dependensi aplikasi Node.js. Namun, jika folder ini sudah ada di root aplikasi sebelum konfigurasi dilakukan oleh NodeJS Selector, sistem akan mendeteksi konflik. Hal ini disebabkan karena NodeJS Selector mencoba membuat symlink (tautan simbolik) ke folder node_modules<\/code> sebagai bagian dari pengaturan virtual environment. Jika folder dengan nama yang sama sudah ada, proses ini gagal dan memunculkan error.<\/p>\n

Selain itu, error ini sering kali terjadi karena beberapa alasan tambahan, seperti:<\/p>\n

    \n
  1. \nPengguna Membuat Folder node_modules<\/code> Secara Manual<\/strong>
    Dalam beberapa kasus, pengguna mungkin secara manual menyalin atau membuat folder node_modules<\/code> di root aplikasi. Ini sering dilakukan untuk menghemat waktu dalam menginstal ulang dependensi. Namun, praktik ini tidak kompatibel dengan cara kerja NodeJS Selector.<\/li>\n\n\n\n
  2. \nProses NPM Install Dilakukan Sebelum Konfigurasi NodeJS Selector<\/strong>
    Jika pengguna menjalankan npm install<\/code> tanpa terlebih dahulu mengatur aplikasi Node.js melalui NodeJS Selector, folder node_modules<\/code> akan dibuat di lokasi yang tidak sesuai dengan kebutuhan sistem.<\/li>\n\n\n\n
  3. \nKesalahan dalam Proses Deploy Proyek<\/strong>
    Ketika proyek Node.js dideploy ke server hosting, folder node_modules<\/code> sering kali sudah termasuk dalam paket yang diunggah. Ini dapat menyebabkan konflik karena NodeJS Selector memerlukan kontrol penuh atas struktur folder tersebut.<\/li>\n<\/ol>\n

    Kesalahan ini biasanya muncul pada hosting<\/a> berbasis CloudLinux yang menggunakan NodeJS Selector, karena sistem ini dirancang untuk mengelola aplikasi Node.js dengan cara yang lebih terisolasi dan aman. Untuk menghindari masalah ini, sangat penting untuk memahami cara kerja NodeJS Selector dan memastikan bahwa foldernode_modules<\/code> tidak dibuat atau disalin secara manual sebelum konfigurasi dilakukan.<\/p>\n\n

    \n<\/span>Cara Mengatasi Error<\/strong><\/span>\n<\/h2>\n

    Untuk mengatasi error ini, Anda dapat mengikuti langkah-langkah berikut:<\/p>\n

    Hapus Folder node_modules<\/code><\/strong><\/p>\n

    \"\"<\/figure><\/div>\n