Как установить Docker CLI и Docker Compose CLI на macOS

Как установить Docker CLI и Docker Compose CLI на macOS

Если вам нужен Docker без Docker Desktop, на macOS удобно поставить только Docker CLI и отдельно Docker Compose CLI. Такой вариант хорошо работает вместе с Colima или удалённым Docker Engine: вы получаете команду docker, а также современную команду docker compose.

Вкратце

Для macOS без Docker Desktop достаточно такого набора:

brew install docker docker-compose

mkdir -p ~/.docker/cli-plugins
ln -sfn $(brew --prefix)/opt/docker-compose/bin/docker-compose ~/.docker/cli-plugins/docker-compose
docker compose version

Это простой и практичный способ получить Docker CLI и Docker Compose CLI в терминале без лишних компонентов.

Что понадобится

Перед установкой убедитесь, что у вас есть Homebrew. Это самый простой способ ставить и обновлять нужные пакеты на macOS. Если Homebrew уже установлен, можно сразу переходить к следующему шагу.

Также полезно понимать разницу между компонентами:

  • Docker CLI — клиентская команда docker.
  • Docker Compose CLI — плагин, который добавляет docker compose.
  • Docker Desktop — отдельное приложение с графическим интерфейсом и встроенной поддержкой Compose.

Если вам нужен только терминал, Docker Desktop не обязателен.

Установка Docker CLI

Сначала установите Docker CLI:

brew install docker

После этого команда docker станет доступна в терминале. Но одной этой установки недостаточно для docker compose, потому что Compose ставится отдельно.

Проверьте установку:

docker version

Если у вас уже запущен Docker Engine, команда покажет информацию о клиенте и сервере. Если сервера нет, это нормально для случая, когда вы используете Colima или удалённый daemon.

Установка Docker Compose CLI

Теперь установите Docker Compose:

brew install docker-compose

На macOS с Homebrew этот пакет обычно ставит сам Compose-бинарник, который можно подключить как CLI-плагин. Для того чтобы команда docker compose работала именно в современном формате, нужно сделать её видимой для Docker CLI.

Создайте каталог плагинов и добавьте симлинк:

mkdir -p ~/.docker/cli-plugins

ln -sfn $(brew --prefix)/opt/docker-compose/bin/docker-compose ~/.docker/cli-plugins/docker-compose

После этого проверьте:

docker compose version

Если всё настроено правильно, вы увидите версию Docker Compose.

Проверка работы

После установки проверьте базовые команды:

docker version
docker compose version
docker compose ps

Если docker version работает, а docker compose version тоже отвечает корректно, значит оба компонента установлены и связаны правильно.

Если вы используете Colima

Для Colima обычно ничего дополнительно делать не нужно, если Docker CLI уже смотрит на нужный контекст. У вас может быть локальный Docker Engine через Colima, а Compose будет работать поверх него как обычная подкоманда.

Полезно проверить текущий контекст:

docker context ls
docker context show

Если активен default или нужный контекст Colima, можно сразу запускать docker compose up.

Возможные проблемы

Если команда docker compose не распознаётся, обычно причина одна из трёх:

  • Не установлен Compose-пакет.
  • Плагин не лежит в ~/.docker/cli-plugins.
  • Симлинк указывает не туда или был сломан после обновления Homebrew.

В таком случае повторите команды установки и проверьте путь:

ls -l ~/.docker/cli-plugins/

brew --prefix
docker  macos  devops