Поиск
Ошибки

Do not run Composer as root/super user! — что делать

Composer запущен от root — вы вошли на сервер как root или набрали sudo composer. Composer предупреждает: скрипты и плагины библиотек получат полный доступ к серверу. Запускайте Composer от своего пользователя, без sudo, в папке, которая ему принадлежит.

≈ 5 мин чтения
Содержание 10

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

  1. Если набрали sudo composer …, наберите ту же команду без sudo.
  2. Если вошли на сервер как root, войдите от своего пользователя — как его создать.
  3. Если без 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 sessionComposer от root в cron или скриптеперенесите задачу к своему пользователю
Plugins have been disabled automatically as you are running as rootскрипт сломался без плагиновперенесите задачу к своему пользователю
без sudo Composer пишет, что нет прав на папкупапка принадлежит rootсделайте себя владельцем
vendor и composer.lock принадлежат rootComposer запускали через sudoверните владельца

Тексты сообщений сверены по исходному коду Composer 2.7.1 — эта версия стоит в Ubuntu 24.04.

Источники

Сверено 13 ноября 2026 года.

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

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