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_modulesyang milik root. - Cache bermasalah: folder
~/.npmdimiliki root karena dulu pernah dijalankan dengansudo 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:
- Cek prefix aktif dengan
npm config get prefix. Jika hasilnya/usr/local, lanjut. - Buat folder global milik user dan perbaiki cache npm.
- Arahkan npm ke folder baru tersebut.
- 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 -guntuk pemakaian harian, karena mengembalikan masalah kepemilikan. - Hindari
--forceuntuk 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.