Amankan Folder Global dengan Cara Mengatasi Npm Permission Denied

Error npm ERR! code EACCES permission denied berarti user Linux atau macOS tidak punya hak tulis ke folder yang dipakai npm. Perbaikan amannya bukan menambah sudo setiap install, melainkan memindahkan folder global ke dalam home user, misalnya ~/.npm-global, lalu memperbaiki kepemilikan cache ~/.npm.

Penyebab npm permission denied paling sering

npm menulis ke tiga lokasi berbeda. Masalah muncul ketika pemilik folder tidak sama dengan user yang menjalankan perintah.

  • Cache: folder ~/.npm terkunci karena pernah dijalankan dengan sudo.
  • Global: npm mencoba menulis ke /usr/local/lib/node_modules yang hanya bisa ditulis root.
  • Proyek lokal: folder proyek hasil clone root, unzip root, atau volume Docker sehingga user biasa tidak bisa menulis.

Cek dulu pemilik dan konfigurasi aktif sebelum mengubah apa pun:

whoami
ls -ld ~/.npm /usr/local/lib/node_modules
npm config get prefix
npm config get cache

Tabel diagnosis cepat berdasarkan pesan error

Gejala Lokasi folder Tindakan aman
EACCES permission denied .npm Cache user Perbaiki owner cache
EACCES /usr/local/lib/node_modules Global sistem Ubah prefix ke home
EACCES saat npm install lokal Folder proyek Perbaiki owner proyek

Gunakan chown hanya untuk folder milik user seperti cache dan proyek. Untuk folder global sistem, ubah prefix lebih aman daripada mengubah owner /usr/local.

Cara memperbaiki npm permission denied yang aman

  1. Konfirmasi user aktif dan lokasi error dengan perintah whoami dan npm config get prefix.
  2. Perbaiki cache user yang terkunci root.
  3. Buat folder global baru di home dan arahkan npm ke sana.
  4. Daftarkan folder bin global ke PATH agar perintah seperti nodemon langsung dikenali.
  5. Uji install global tanpa sudo.
sudo chown -R $(whoami):$(whoami) ~/.npm
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
npm install -g npm@latest

Tambahkan baris export PATH tersebut ke ~/.bashrc atau ~/.zshrc, lalu jalankan ulang terminal. sudo npm install -g membuat file baru milik root, merusak cache, dan membuka risiko script install berjalan sebagai root. Pakai sudo hanya untuk perbaikan kepemilikan satu kali, bukan untuk install harian.

FAQ

Apakah aman pakai sudo npm install?

Tidak untuk pemakaian harian karena file global dan cache berubah menjadi milik root.

Kenapa error muncul lagi setelah ganti versi Node?

Installer baru sering mengembalikan prefix ke folder sistem, sehingga perlu atur ulang prefix ke home.

Apakah hapus cache dengan –force aman?

Tidak menyelesaikan masalah izin dan berisiko, perbaiki owner folder cache terlebih dahulu.