npm EACCES Permission Denied Hatası Nasıl Çözülür? 5 Kesin Çözüm (2026)

EACCES Hatası Nedir? (What is EACCES Error?)

Terminal'de şöyle bir hata mı görüyorsunuz?

Hata Mesajı / Error Message

JavaScript

npm ERR! Error: EACCES: permission denied, access '/usr/local/lib/node_modules'
npm ERR! { [Error: EACCES: permission denied, access '/usr/local/lib/node_modules']
npm ERR!   errno: -13,
npm ERR!   code: 'EACCES',
npm ERR!   syscall: 'access',
npm ERR!   path: '/usr/local/lib/node_modules' }

npm ERR! Please try running this command again as root/Administrator.

Alesta Web olarak bu hatayı yüzlerce kez gördük. EACCES (Error ACCESs), Linux/macOS sistemlerde "erişim izni yok" anlamına geliyor. npm, global paket kurulumu yaparken yazma izni olmayan bir dizine erişmeye çalışıyor.

⚠️ Uyarı / Warning:

sudo npm install -g kullanmak geçici bir çözümdür ve güvenlik riskleri taşır! Bu rehberde kalıcı ve güvenli çözümleri göstereceğiz.

Neden Bu Hatayı Alıyoruz? (Why Does This Error Occur?)

EACCES hatası şu durumlarda ortaya çıkar:

Global npm dizini: /usr/local/lib/node_modules root kullanıcıya ait
npm cache: ~/.npm dizininde izin sorunları
Node kurulumu: Sistem paket yöneticisiyle (apt, brew) yapıldığında
Önceki sudo kullanımı: Daha önce sudo ile kurulum yapıldıysa dosya sahiplikleri karışmış olabilir

Sorunu Teşhis Et / Diagnose the Problem

Bash

# npm global dizininin sahipliğini kontrol et
ls -la /usr/local/lib/node_modules

# npm config dizinini gör
npm config get prefix

# npm cache dizininin sahipliğini kontrol et
ls -la ~/.npm

Çözüm 1: Node Version Manager (nvm) - Önerilen (Recommended)

Alesta Web olarak en çok önerdiğimiz yöntem bu! nvm (Node Version Manager) ile Node.js'i kullanıcı dizininize kurarsınız ve hiçbir izin sorunu yaşamazsınız.

Adım 1: nvm Kurulumu (Install nvm)

Bash

# Linux/macOS için
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# veya wget ile
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# Terminal'i yeniden başlat veya:
source ~/.bashrc
# veya zsh kullanıyorsanız:
source ~/.zshrc

Adım 2: Node.js Kurulumu (Install Node.js)

PHP

# En son LTS sürümünü kur
nvm install --lts

# Veya belirli bir versiyon
nvm install 22

# Varsayılan olarak ayarla
nvm alias default 22

# Kontrol et
node -v
npm -v

Adım 3: Global Paket Kurulumu (Install Global Package)

Bash

# Artık sudo gerekmeden çalışır!
npm install -g typescript
npm install -g @angular/cli
npm install -g create-react-app

# Hiç EACCES hatası yok! No more permission errors!

✅ Neden nvm Öneriyoruz?

Birden fazla Node.js versiyonu arasında geçiş yapabilirsiniz
Proje bazlı Node versiyonu kullanabilirsiniz (.nvmrc)
İzin sorunları tamamen ortadan kalkar
Sistem Node'una dokunmaz, güvenlidir

Çözüm 2: npm Dizin Değiştirme (Change npm Directory)

nvm kullanmak istemiyorsanız, npm'in global paket dizinini değiştirebilirsiniz:

Adım 1: Yeni Dizin Oluştur

Bash

# Kullanıcı klasörünüzde yeni npm dizini
mkdir ~/.npm-global

Adım 2: npm Prefix Ayarla

Bash

# npm'e yeni dizini göster
npm config set prefix '~/.npm-global'

Adım 3: PATH'e Ekle

Bash

# ~/.bashrc veya ~/.zshrc dosyasına ekle:
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Değişiklikleri uygula
source ~/.bashrc

Adım 4: Test Et

Bash

# Artık sudo gerekmez!
npm install -g nodemon

# Kurulumu kontrol et
which nodemon
# Çıktı: ~/.npm-global/bin/nodemon

? İpucu / Tip:

Bu yöntem sisteminizde tek bir Node.js versiyonu kullanıyorsanız idealdir. Birden fazla versiyon gerekiyorsa nvm kullanın.

Çözüm 3: Sahiplik Değiştirme (Change Ownership - chown)

Mevcut npm dizininin sahipliğini kullanıcınıza aktarabilirsiniz. Bu yöntem hızlıdır ama dikkatli olun!

npm Dizini Sahipliğini Değiştir

Bash

# Mevcut kullanıcıya sahiplik ver
sudo chown -R $(whoami) /usr/local/lib/node_modules

# npm prefix dizinini de değiştir
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

# npm cache dizinini düzelt
sudo chown -R $(whoami) ~/.npm

⚠️ Dikkat / Warning:

Bu yöntem sistem dizinlerini değiştirir. Çok kullanıcılı sistemlerde (shared server) sorun yaratabilir. Alesta Web olarak bu yöntemi sadece kişisel bilgisayarlarda öneriyoruz.

Alternatif: Sadece Cache Düzeltme

Bash

# Bazen sadece cache sorunu vardır
sudo chown -R $(whoami) ~/.npm
npm cache clean --force

Çözüm 4: npx Kullanımı (Use npx Instead)

Global kurulum yapmadan paketleri çalıştırmak için npx kullanabilirsiniz:

npx ile Doğrudan Çalıştırma

SQL

# Global kurulum yerine npx kullan
# Eski yöntem (global kurulum gerekli):
npm install -g create-react-app
create-react-app my-app

# Yeni yöntem (global kurulum gereksiz):
npx create-react-app my-app

# Diğer örnekler:
npx typescript --init
npx eslint --init
npx prettier --write .

✅ npx Avantajları:

Global kurulum gerekmez (no global installation needed)
Her zaman en son versiyon kullanılır
İzin sorunları olmaz
Disk alanı tasarrufu

Çözüm 5: Windows İçin Çözümler (Windows Solutions)

Windows'ta EACCES hatası farklı şekilde ortaya çıkar:

Yöntem 1: PowerShell'i Yönetici Olarak Çalıştır

Bash

# PowerShell'i sağ tık > "Yönetici olarak çalıştır"
# Sonra npm komutunu çalıştır
npm install -g typescript

Yöntem 2: npm Cache Temizle

Bash

# npm cache temizle
npm cache clean --force

# AppData klasörünü kontrol et
# C:\Users\KullanıcıAdı\AppData\Roaming\npm

Yöntem 3: nvm-windows Kullan (Önerilen)

Bash

# nvm-windows indir:
# https://github.com/coreybutler/nvm-windows/releases

# Kurulumdan sonra:
nvm install 22
nvm use 22

# Artık izin sorunu yok!

Yöntem 4: Environment Variables Düzenle

Python

1. Windows Başlat > "Ortam Değişkenleri" ara
2. "Sistem ortam değişkenlerini düzenle" tıkla
3. "Ortam Değişkenleri" butonuna tıkla
4. "Path" değişkenini seç > "Düzenle"
5. npm global dizinini ekle:
   C:\Users\KullanıcıAdı\AppData\Roaming\npm

? Kaynaklar ve Referanslar / Sources and References

Bu makalede kullanılan bilgiler aşağıdaki güvenilir kaynaklardan derlenmiştir:

npm Docs - Resolving EACCES Permissions Errors - Resmi npm dokümantasyonu
nvm GitHub Repository - Node Version Manager
nvm-windows GitHub - Windows için nvm
Let's Code Pare - npm EACCES Guide

Alesta Web olarak tüm çözümleri test ettik ve doğruladık.

✅ Sorun Çözüldü! (Problem Solved!)

Artık npm EACCES: permission denied hatası (npm permission error) geride kaldı! Alesta Web olarak en çok nvm kullanımını öneriyoruz çünkü hem güvenli hem de çok kullanışlı.

Hızlı Özet / Quick Summary:

✅ En iyi çözüm: nvm kullanın (use nvm - recommended)
✅ Alternatif: npm dizinini ~/.npm-global'a taşıyın
✅ Geçici: sudo chown ile sahiplik değiştirin
✅ Modern: npx ile global kurulum atlatın
✅ Windows: nvm-windows veya yönetici PowerShell

⚠️ Hatırlatma:

sudo npm install -g kullanmaktan kaçının! Bu güvenlik riski oluşturur ve gelecekte daha fazla izin sorunu yaratır.

Faydalı Linkler / Useful Links:

Alesta Web Ana Sayfa: alestaweb.com
Diğer npm Rehberleri: Tüm Makaleler

npm EACCES Permission Denied Hatası Nasıl Çözülür? 5 Kesin Çözüm (2026)

İçindekiler / Table of Contents

EACCES Hatası Nedir? (What is EACCES Error?)

Hata Mesajı / Error Message

Neden Bu Hatayı Alıyoruz? (Why Does This Error Occur?)

Sorunu Teşhis Et / Diagnose the Problem

Çözüm 1: Node Version Manager (nvm) - Önerilen (Recommended)

Adım 1: nvm Kurulumu (Install nvm)

Adım 2: Node.js Kurulumu (Install Node.js)

Adım 3: Global Paket Kurulumu (Install Global Package)

Çözüm 2: npm Dizin Değiştirme (Change npm Directory)

Adım 1: Yeni Dizin Oluştur

Adım 2: npm Prefix Ayarla

Adım 3: PATH'e Ekle

Adım 4: Test Et

Çözüm 3: Sahiplik Değiştirme (Change Ownership - chown)

npm Dizini Sahipliğini Değiştir

Alternatif: Sadece Cache Düzeltme

Çözüm 4: npx Kullanımı (Use npx Instead)

npx ile Doğrudan Çalıştırma

Çözüm 5: Windows İçin Çözümler (Windows Solutions)

Yöntem 1: PowerShell'i Yönetici Olarak Çalıştır

Yöntem 2: npm Cache Temizle

Yöntem 3: nvm-windows Kullan (Önerilen)

Yöntem 4: Environment Variables Düzenle

? Kaynaklar ve Referanslar / Sources and References

✅ Sorun Çözüldü! (Problem Solved!)

Projenizi birlikte planlayalım