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
- Konfirmasi user aktif dan lokasi error dengan perintah whoami dan npm config get prefix.
- Perbaiki cache user yang terkunci root.
- Buat folder global baru di home dan arahkan npm ke sana.
- Daftarkan folder bin global ke PATH agar perintah seperti nodemon langsung dikenali.
- 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.