Akses Ditolak saat Install? Cara Mengatasi Npm Err Code Eacces Global

npm err code EACCES berarti user aktif tidak punya izin tulis ke folder yang dipakai npm. Perbaikan paling aman untuk install global: pindahkan prefix npm ke folder milik user sendiri, bukan memaksa pakai sudo.

Penyebab Umum EACCES di npm

Error ini hampir selalu soal kepemilikan folder, bukan soal package yang rusak. Lokasi bermasalah perlu dibedakan dulu.

  • Install global gagal: npm mencoba tulis ke /usr/local/lib/node_modules yang milik root.
  • Cache bermasalah: folder ~/.npm dimiliki root karena dulu pernah dijalankan dengan sudo npm install.
  • Proyek lokal ikut error: file di dalam proyek berubah pemiliknya setelah perintah sudo, sehingga npm biasa tidak bisa menulis lagi.

Cek dua titik ini sebelum memperbaiki:

npm config get prefix
ls -la ~/.npm
ls -la /usr/local/lib/node_modules

Tabel Diagnosis Cepat Error EACCES

Log EACCES biasanya memuat errno: -13, syscall: mkdir/open, dan path yang ditolak. Lihat path itu untuk menentukan solusi.

Lokasi Error Penyebab Solusi
/usr/local/lib/node_modules Prefix global milik root Pindah prefix ke ~/.npm-global
~/.npm/_cacache Cache dimiliki root Kembalikan pemilik dengan chown
Folder proyek lokal node_modules milik root Perbaiki owner proyek, hindari sudo

Perbaiki Izin Folder Global Tanpa Merusak Sistem

Cara ini tidak mengubah izin folder sistem. Ikuti berurutan:

  1. Cek prefix aktif dengan npm config get prefix. Jika hasilnya /usr/local, lanjut.
  2. Buat folder global milik user dan perbaiki cache npm.
  3. Arahkan npm ke folder baru tersebut.
  4. Tambahkan folder bin baru ke PATH agar perintah global dikenali.
mkdir ~/.npm-global
sudo chown -R $(whoami) ~/.npm ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Tambahkan baris export di atas ke ~/.bashrc atau ~/.zshrc, lalu jalankan source ~/.bashrc.

  • Hindari sudo npm install -g untuk pemakaian harian, karena mengembalikan masalah kepemilikan.
  • Hindari --force untuk error izin, karena tidak memperbaiki root cause dan bisa menimpa file.
  • Jangan hapus paksa folder sistem seperti /usr/local/lib, risikonya merusak instalasi Node.

FAQ

Apakah aman memakai sudo npm install?

Tidak untuk pemakaian rutin, karena file cache dan node_modules bisa berpindah ke root dan memicu EACCES berikutnya.

Kenapa EACCES muncul lagi setelah diperbaiki?

Umumnya karena satu perintah sudo dipakai lagi atau terminal berjalan tanpa PATH baru, sehingga prefix lama kembali terpakai.

Perlukah hapus package-lock.json untuk EACCES?

Tidak perlu, karena EACCES adalah masalah izin sistem file, bukan konflik versi dependency.