Ошибка docker compose command not found: почему команда не найдена и как исправить
Оболочка пишет docker compose: command not found, когда исполняемого файла docker-compose нет в PATH или не установлен плагин Compose v2. Сначала проверьте, что выводит docker compose version и docker info, затем посмотрите, какие пакеты Docker установлены.
01Плагин docker-compose-plugin не установлен
Docker Compose v2 поставляется отдельным пакетом docker-compose-plugin, и без него подкоманда compose у docker отсутствует. Проверить наличие плагина можно командой docker compose version: если она печатает версию, проблема в другом. Если пакета нет, установите его из репозитория Docker и повторите проверку.
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.
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.
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 урезана, команда не находится. Проверьте, где лежит бинарник, и убедитесь, что каталог плагинов существует.
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. Если файл в порядке, поднимите сервисы и посмотрите их состояние.
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 Ошибка error response from daemon docker: причины и исправление Разбираем ошибки Docker и Docker Compose: занятый порт, permission denied на docker.sock, YAML, права на каталог. Команды проверки и исправления.
- Ошибка · Docker Docker Compose up не запускается: ошибки и способы их устранения Почему docker compose up не запускается: разбор ошибок с портами, образами, правами и синтаксисом. Команды для диагностики и исправления.
- Ошибка · Docker Ошибка permission denied при монтировании volume в Docker Compose Разбираем ошибку permission denied при монтировании volume в Docker Compose: проверка прав, настройка пользователя в контейнере, команды для исправления.
- Руководство · Docker docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы