К содержимому

Ошибка docker compose command not found: почему команда не найдена и как исправить

Оболочка пишет docker compose: command not found, когда исполняемого файла docker-compose нет в PATH или не установлен плагин Compose v2. Сначала проверьте, что выводит docker compose version и docker info, затем посмотрите, какие пакеты Docker установлены.

Ошибка Docker 3 мин чтения

01Плагин docker-compose-plugin не установлен

Docker Compose v2 поставляется отдельным пакетом docker-compose-plugin, и без него подкоманда compose у docker отсутствует. Проверить наличие плагина можно командой docker compose version: если она печатает версию, проблема в другом. Если пакета нет, установите его из репозитория Docker и повторите проверку.

bash
sudo apt update
sudo apt install docker-compose-plugin
docker compose version

02Установлен только старый docker-compose v1

Пакет docker-compose из старых инструкций ставит отдельный бинарник v1, который не поддерживается с 2023 года и не даёт подкоманду docker compose. Признак: docker-compose version отвечает, а docker compose version пишет command not found. Удалите старый пакет и поставьте плагин v2.

bash
sudo apt remove docker-compose
docker-compose version
docker compose version

03Docker установлен из репозитория Ubuntu без плагина

В репозитории Ubuntu 24.04 есть пакеты docker.io и docker-compose-v2, но набор и версии отличаются от репозитория Docker. Посмотрите, что установлено: dpkg -l | grep -E 'docker|containerd'. Если нужен официальный набор, подключите репозиторий Docker и поставьте docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin и docker-compose-plugin.

bash
dpkg -l | grep -E 'docker|containerd'
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker compose version

04Файл плагина есть, но его нет в PATH

Плагин CLI ищет исполняемые файлы docker-compose в каталогах ~/.docker/cli-plugins и /usr/libexec/docker/cli-plugins. Если файл лежит в другом месте или переменная PATH урезана, команда не находится. Проверьте, где лежит бинарник, и убедитесь, что каталог плагинов существует.

bash
which docker
docker info --format '{{range .ClientInfo.Plugins}}{{.Name}} {{.Path}}{{"\n"}}{{end}}'
ls -l /usr/libexec/docker/cli-plugins/

05Проверка, что ошибка ушла

После установки плагина команда должна печатать версию без sudo и без ошибок. Затем перейдите в каталог проекта с compose.yaml и проверьте конфиг через docker compose config. Если файл в порядке, поднимите сервисы и посмотрите их состояние.

bash
docker compose version
docker compose config
docker compose up -d
docker compose ps

Что не помогает

  • Запускать newgrp docker вместо повторного входа в систему после sudo usermod -aG docker $USER.

    newgrp docker открывает новую оболочку с группой docker, но не обновляет группы у уже запущенных процессов и не заменяет полноценный вход. Выйдите из сессии и войдите заново, затем проверьте id.

  • Ставить docker-compose из pip или скачивать бинарник v1 со сторонних страниц.

    Ставьте docker-compose-plugin из репозитория Docker: команда docker compose пишется через пробел, а v1 не поддерживается с 2023 года.

  • Добавлять version: в начало compose.yaml, чтобы «починить» Compose.

    В Compose v2 ключ version: устарел и даёт только предупреждение. Уберите его, ошибка command not found от него не зависит.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем docker compose отличается от docker-compose?

docker compose это плагин Compose v2, он входит в пакет docker-compose-plugin и вызывается как подкоманда docker. docker-compose это отдельный бинарник v1, который не поддерживается с 2023 года.

Почему после установки плагина команда всё равно не находится?

Проверьте docker compose version и docker info: если плагин не виден в списке, файл лежит не в /usr/libexec/docker/cli-plugins или ~/.docker/cli-plugins. Также убедитесь, что в PATH есть каталог с docker.

Нужен ли sudo для docker compose?

По умолчанию сокет /var/run/docker.sock доступен только root. Чтобы работать без sudo, добавьте пользователя в группу docker командой sudo usermod -aG docker $USER и войдите в систему заново.

Как проверить compose-файл перед запуском?

Выполните docker compose config в каталоге проекта: команда проверит YAML и напечатает итоговый конфиг. Ошибки отступов и кавычек видны прямо в её выводе.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.