Do not run Composer as root/super user! — что делать
Composer запущен от root — вы вошли на сервер как root или набрали sudo composer. Composer предупреждает: скрипты и плагины библиотек получат полный доступ к серверу. Запускайте Composer от своего пользователя, без sudo, в папке, которая ему принадлежит.
Содержание 10
Что сделать прямо сейчас
- Если набрали
sudo composer …, наберите ту же команду безsudo. - Если вошли на сервер как root, войдите от своего пользователя — как его создать.
- Если без sudo пишет, что нет прав на папку проекта, — сделайте себя её владельцем.
Как выглядит ошибка
Do not run Composer as root/super user! See https://getcomposer.org/root for details
Continue as root/super user [yes]?Первая строка — «не запускайте Composer от root, подробности по ссылке». Вторая — вопрос «продолжить от root?». В квадратных скобках — ответ, который будет, если просто нажать Enter: yes, Composer продолжит. Если ответить no, Composer остановится и ничего не сделает.
Ссылка ведёт на страницу документации Composer о безопасной установке пакетов.
Почему Composer против root
Команды composer install и composer update выполняют чужой код: скрипты из composer.json и плагины библиотек. Этот код работает с правами того, кто запустил Composer. От root — с полным доступом к серверу: он может прочитать и поменять любой файл. Если в библиотеку попал вредный код, он получит весь сервер, а не одну папку сайта.
Вторая беда — файлы. Всё, что Composer создаст от root, — папка vendor, composer.lock, — будет принадлежать root. Потом ваш пользователь не сможет их поменять, а следующий composer install без sudo споткнётся о права.
Как запускать Composer
Запускайте Composer от своего пользователя, в папке проекта, которая ему принадлежит:
cd /var/www/example.com
composer installКому принадлежит папка, покажет команда:
ls -ld /var/www/example.comВ ответе после прав и числа — владелец и группа, например root root. Если владелец не вы, сделайте себя владельцем — тогда Composer заработает без sudo. Подробнее о команде — chown.
Если vendor уже создан от root
Если Composer уже запускали через sudo, верните папке vendor и файлу composer.lock того же владельца, что у папки проекта:
cd /var/www/example.com
sudo chown -R --reference=. vendor composer.lock--reference=. — взять владельца и группу у текущей папки, -R — для всех файлов внутри vendor. Проверьте: ls -l — у vendor и composer.lock тот же владелец, что у остальных файлов.
Если Composer запускается из cron или скрипта
Когда Composer работает без окна, где можно ответить на вопрос, — в cron, в скрипте выкладки, — он пишет:
Composer plugins have been disabled for safety in this non-interactive session. Set COMPOSER_ALLOW_SUPERUSER=1 if you want to allow plugins to run as root/super user.
Do not run Composer as root/super user! See https://getcomposer.org/root for details«Плагины Composer отключены из соображений безопасности: команда работает без диалога». Composer продолжит работу, но без плагинов. Если скрипт из composer.json после этого завершится с ошибкой, Composer добавит строку Plugins have been disabled automatically as you are running as root, this may be the cause of the script failure. — «плагины отключены, возможно, из-за этого и сломался скрипт».
Что сделать: запускайте задачу от своего пользователя, а не от root. Задачу cron добавляйте в свой список — командой crontab -e без sudo: как добавить задачу в cron.
Если без root никак
Переменная COMPOSER_ALLOW_SUPERUSER=1 говорит Composer: «я знаю, что работаю от root». Предупреждения и вопроса не будет, плагины включатся:
COMPOSER_ALLOW_SUPERUSER=1 composer installБезопаснее от этого не становится: скрипты и плагины работают с правами root. Если без root никак, а библиотекам вы не доверяете, документация Composer советует отключить и плагины, и скрипты:
composer install --no-plugins --no-scriptsТогда выполнится только код самого Composer. Но шаги, которые проект делает после установки, — например, php artisan package:discover в Laravel, — не выполнятся, их придётся запускать отдельно.
В контейнере Docker — там, где есть файл /.dockerenv, — Composer эту проверку не делает.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Do not run Composer as root/super user! | Composer запущен от root или через sudo | запускайте от своего пользователя |
Continue as root/super user [yes]? | Composer спрашивает, продолжать ли | ответьте no и запустите без sudo |
Composer plugins have been disabled for safety in this non-interactive session | Composer от root в cron или скрипте | перенесите задачу к своему пользователю |
Plugins have been disabled automatically as you are running as root | скрипт сломался без плагинов | перенесите задачу к своему пользователю |
| без sudo Composer пишет, что нет прав на папку | папка принадлежит root | сделайте себя владельцем |
| vendor и composer.lock принадлежат root | Composer запускали через sudo | верните владельца |
Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код Composer 2.7.1 — на английском: проверка root в Console/Application.php.
- Как безопасно ставить пакеты — на английском: почему не стоит запускать Composer от root и ключи --no-plugins и --no-scripts.
- Команды Composer — на английском: переменная COMPOSER_ALLOW_SUPERUSER.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Как установить Composer на Ubuntuпочему Composer запускают без sudo.
- Команда sudoкогда она нужна, а когда нет.
- Ошибки Composerвсе ошибки Composer на одной странице.