Поиск
Ошибки

npm: EACCES permission denied — нет прав при установке пакетов

Ошибка значит: npm не смог создать папку или записать файл — у вашего пользователя нет на неё прав. Что делать, видно по строке path в сообщении. Путь в /usr/local — повторите установку с sudo: sudo npm install -g имя-пакета. Путь в папке проекта — верните папку себе командой sudo chown -R и ставьте пакеты без sudo. Путь в ~/.npm — выполните команду, которую npm напечатал в сообщении.

≈ 12 мин чтения3 шага
Содержание 12

Что сделать прямо сейчас

  1. Найдите в сообщении строку path — это папка или файл, куда npm не смог записать.
  2. Путь начинается с /usr/local — вы ставили пакет с ключом -g. Повторите команду с sudo, например sudo npm install -g pm2.
  3. Путь лежит в папке проекта — верните папку своему пользователю: sudo chown -R ivan:ivan /home/ivan/myapp, затем повторите npm install без sudo.
  4. Путь лежит в ~/.npm — выполните команду sudo chown -R …, которую npm напечатал в конце сообщения.

Вместо ivan и /home/ivan/myapp подставьте имя своего пользователя и папку своего проекта. Имя пользователя показывает команда whoami. Подробности каждого случая — в шагах ниже.

Как выглядит ошибка

npm ERR! code EACCES
npm ERR! syscall mkdir
npm ERR! path /usr/local/lib/node_modules
npm ERR! errno -13
npm ERR! …
npm ERR!
npm ERR! The operation was rejected by your operating system.
npm ERR! It is likely you do not have the permissions to access this file as the current user
npm ERR!
npm ERR! If you believe this might be a permissions issue, please double-check the
npm ERR! permissions of the file and its containing directories, or try running
npm ERR! the command again as root/Administrator.

В строке syscall — что npm пытался сделать: mkdir — создать папку, open — открыть файл, rename — переименовать. Главное — строка path: это папка или файл, куда записать не вышло. В вашем сообщении syscall и path могут быть другими. Тексты сверены с исходным кодом npm 9.2.0 — эта версия ставится из пакетов Ubuntu 24.04 и 26.04 — и npm 10.9.4, который идёт вместе с Node.js 22.22.1 с сайта nodejs.org. В npm 10 строки начинаются с npm error вместо npm ERR!, а предупреждения — с npm warn вместо npm WARN.

Если не хватает прав в кэше npm, сообщение другое — npm сам пишет команду для исправления:

npm ERR! …
npm ERR!
npm ERR! Your cache folder contains root-owned files, due to a bug in
npm ERR! previous versions of npm which has since been addressed.
npm ERR!
npm ERR! To permanently fix this problem, please run:
npm ERR!   sudo chown -R 1000:1000 "/home/ivan/.npm"

Что за папка в строке path

Путь начинается сЧто этоЧто делать
/usr/local/lib/node_modules или /usr/local/binпапка для пакетов, которые ставят командой npm install -gшаг 1
/home/ivan/myappпапка вашего проекташаг 2
/var/www/example.comпапка сайташаг 2
/var/www/.npmкэш пользователя www-data: npm запускали от его именишаг 2, последний абзац
/home/ivan/.npmкэш npmшаг 3

Шаг 1. Глобальные пакеты с -g

Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.

npm из пакетов Ubuntu ставит глобальные пакеты в /usr/local: так задано в его файле настроек. Записывать туда может только root. Проверить, куда ставит ваш npm:

npm config get prefix

Есть два пути. Первый — поставить пакет с sudo. Так ставят программы для всего сервера, например менеджер процессов PM2:

sudo npm install -g pm2

Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — так и должно быть: наберите пароль и нажмите Enter. На вопрос Do you want to continue? [Y/n] нажмите Y и Enter.

Второй путь — из документации npm: ставить глобальные пакеты в папку внутри домашней, тогда sudo не нужен. Укажите npm новую папку:

npm config set prefix ~/.local

Откройте файл ~/.profile в редакторе nano:

nano ~/.profile

Добавьте в конец строку — она говорит системе искать команды в ~/.local/bin (что такое PATH):

PATH=~/.local/bin:$PATH

Сохраните файл и примените его в текущем окне:

source ~/.profile

Теперь npm install -g без sudo ставит пакеты в ~/.local. Сама документация npm на первое место ставит третий путь — установить Node.js через менеджер версий, тогда npm тоже пишет в домашнюю папку.

Шаг 2. Папка проекта

Если в path — папка проекта, часть файлов в ней принадлежит другому пользователю. Так бывает, если проект копировали от root или однажды запускали sudo npm install. Посмотрите владельца:

ls -la /home/ivan/myapp

В третьей колонке — владелец. Верните папку своему пользователю, вместо ivan — ваш (команда chown):

sudo chown -R ivan:ivan /home/ivan/myapp

И повторите установку без sudo:

cd /home/ivan/myapp
npm install

Пакеты проекта ставьте без sudo: иначе node_modules снова будет принадлежать root. Начиная с версии 9 npm не меняет владельца файлов, которые создаёт: всё, что появилось в папке после команды с sudo, остаётся за root, и следующая команда без sudo останавливается с EACCES.

Проверить, остались ли в папке чужие файлы:

find /home/ivan/myapp ! -user ivan | head

Команда печатает первые десять файлов и папок, у которых владелец — не ivan. Пустой ответ значит, что чужих файлов нет.

Если в path стоит /var/www/.npm, npm запускали от пользователя www-data — например, командой sudo -u www-data npm install. Домашняя папка www-data — /var/www, она принадлежит root, и создать в ней кэш www-data не может. Запускайте npm от своего пользователя, а папку проекта верните себе командой sudo chown из этого шага.

Шаг 3. Кэш npm

Кэш npm лежит в папке ~/.npm. Если в нём есть файлы root, npm пишет команду с sudo chown — скопируйте её из сообщения и выполните. Числа 1000:1000 в ней — номера вашего пользователя и его группы, npm подставляет их сам. Для пользователя ivan это то же, что:

sudo chown -R ivan:ivan /home/ivan/.npm

То же сообщение появляется у команды npx: пакеты для запуска она складывает в тот же кэш. Проверить, остались ли в кэше чужие файлы, можно той же командой find:

find ~/.npm ! -user ivan | head

Пустой ответ — кэш целиком ваш.

Проверка прав командой npm doctor

У npm есть своя проверка прав. Перейдите в папку проекта и выполните:

cd /home/ivan/myapp
npm doctor permissions

Команда ничего не меняет: она только смотрит владельца и права в кэше, в папке node_modules проекта и в папках глобальных пакетов. В ответе пять строк о правах — в npm 9 они начинаются со слов Perms check on, в npm 10 — Checking permissions on. Рядом с каждой должно стоять ok. В npm 10 это слово пишется с большой буквы и стоит на следующей строке: Ok или Not ok.

Что в ответеЧто значитЧто делать
not ok в строке cached files и совет Check the permissions of files in /home/ivan/.npm (should be owned by current user)в кэше есть файлы другого пользователяшаг 3
not ok в строке local node_modulesв node_modules проекта есть файлы другого пользователя или группы либо у вас нет права читать их или изменятьшаг 2
предупреждение со словами should be owner of и путём к файлуэтот файл принадлежит не вамшаг 2 или шаг 3 — смотря где лежит файл

Строка global node_modules покажет ok и тогда, когда глобальные пакеты ставятся в /usr/local: в ней npm проверяет только право чтения. Для глобальных пакетов смотрите строку path из ошибки и шаг 1.

Если кэш большой, проверка идёт не сразу — npm 10 сам предупреждает об этом словами this may take awhile.

Где полный журнал ошибки

В конце сообщения npm пишет, куда сохранил подробный журнал:

npm ERR! A complete log of this run can be found in:
npm ERR!     /home/ivan/.npm/_logs/2026-11-15T10_05_00_000Z-debug-0.log

В npm 10 путь стоит в той же строке, сразу после двоеточия. Журналы лежат в папке _logs внутри кэша, в имени файла — дата и время запуска по UTC. npm хранит не больше десяти таких файлов. Последние строки журнала покажет команда tail -n 30 с путём из сообщения.

Если прав нет на сам кэш, журнал тоже не запишется. Тогда вместо пути npm сообщает: Log files were not written due to an error writing to the directory — и предлагает повторить команду с ключом --loglevel=verbose, чтобы подробности появились прямо в окне. Чинится это шагом 3.

Как проверить

Повторите команду, которая выдавала ошибку. Если пакет глобальный, проверьте, что команда появилась — например, для PM2:

pm2 -v

Ответ — номер версии. Если ставили без sudo в ~/.local, файл команды лежит в ~/.local/bin.

Ответы на вопросы

Можно ли запускать npm с sudo каждый раз? Для глобальных пакетов — да, это первый путь из шага 1. В папке проекта — нет: файлы, созданные под sudo, остаются за root, и без sudo npm снова остановится с EACCES.

В сообщении code EPERM, а не EACCES — это другая ошибка? npm объясняет обе одинаково — словами The operation was rejected by your operating system. Действуйте так же: по строке path определите папку и переходите к нужному шагу.

Что значит errno -13? 13 — номер ошибки EACCES в Linux. Нового он не сообщает: что именно не удалось, сказано в строках syscall и path.

У моего пользователя нет sudo — что делать? Для глобальных пакетов подходит второй путь из шага 1 — папка внутри домашней, sudo для него не нужен. Если же чужие файлы лежат в папке проекта или в кэше, вернуть их себе без sudo нельзя: попросите администратора сервера или поддержку хостинга сменить владельца.

Как вернуть папку глобальных пакетов обратно? Удалите свою настройку командой npm config delete prefix. После этого npm config get prefix покажет прежнюю папку — для npm из пакетов Ubuntu это /usr/local. Пакеты, которые вы уже поставили в ~/.local, останутся на месте.

EACCES появляется не при установке, а при запуске приложения — это то же самое? Нет. Если в сообщении есть слово listen и номер порта, например 0.0.0.0:80, приложению не хватило прав занять порт. Разбор — на странице listen EACCES.

Источники

Сверено 22 октября 2026 года; npm doctor, владелец файлов после sudo, журнал, папка /var/www/.npm и ответы на вопросы — 15 ноября 2026 года по исходному коду npm 9.2.0 и 10.9.4.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше