npm: EACCES permission denied — нет прав при установке пакетов
Ошибка значит: npm не смог создать папку или записать файл — у вашего пользователя нет на неё прав. Что делать, видно по строке path в сообщении. Путь в /usr/local — повторите установку с sudo: sudo npm install -g имя-пакета. Путь в папке проекта — верните папку себе командой sudo chown -R и ставьте пакеты без sudo. Путь в ~/.npm — выполните команду, которую npm напечатал в сообщении.
Содержание 12
Что сделать прямо сейчас
- Найдите в сообщении строку
path— это папка или файл, куда npm не смог записать. - Путь начинается с /usr/local — вы ставили пакет с ключом
-g. Повторите команду с sudo, напримерsudo npm install -g pm2. - Путь лежит в папке проекта — верните папку своему пользователю:
sudo chown -R ivan:ivan /home/ivan/myapp, затем повторитеnpm installбез sudo. - Путь лежит в ~/.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.
Источники
- Исходный код npm 9.2.0: lib/utils/error-message.js — текст EACCES и сообщение про файлы root в кэше с командой sudo chown.
- Исходный код npm 9.2.0: lib/utils/exit-handler.js — строки code, syscall, path, errno и путь к полному журналу.
- Исходный код npm 10.9.4: lib/utils/display.js — в npm 10 строки начинаются с
npm errorиnpm warn. - Документация npm: Resolving EACCES permissions errors — менеджер версий или
npm config set prefix ~/.localи строка PATH в ~/.profile. - Журнал изменений npm 9 — с версии 9.0.0 npm не меняет владельца файлов, которые создаёт.
- Исходный код npm 9.2.0: lib/commands/doctor.js — пять проверок прав, слова ok и not ok, тексты советов.
- Исходный код npm 10.9.4: lib/commands/doctor.js — те же проверки в npm 10.
- Документация npm 9.2.0: npm doctor — на английском: проверки можно ограничить словом permissions.
- Исходный код npm 10.9.4: lib/npm.js — где лежит журнал и что npm пишет, если записать его не вышло.
- Справка sudoers для Ubuntu 24.04 — на английском: sudo задаёт домашнюю папку того пользователя, от чьего имени запущена команда.
- Документация npm 10: config — кэш по умолчанию в ~/.npm.
- Файл настроек npm в пакете Ubuntu 24.04 — prefix=/usr/local для глобальных пакетов.
Сверено 22 октября 2026 года; npm doctor, владелец файлов после sudo, журнал, папка /var/www/.npm и ответы на вопросы — 15 ноября 2026 года по исходному коду npm 9.2.0 и 10.9.4.
Что почитать дальше
- Как установить PM2 на Ubuntuменеджер процессов для Node.js.
- Команда chownкак сменить владельца файлов.
- Переменная PATHгде система ищет команды.
- Все ошибки Node.js и npmтаблица по тексту сообщения.