Установка Docker Compose на Ubuntu 24.04
Docker Compose входит в пакет docker-compose-plugin из официального репозитория Docker и ставится одной командой apt после подключения репозитория. На чистом Ubuntu 24.04 это занимает несколько минут: добавить ключ и репозиторий, установить docker-ce и плагин, описать сервисы в compose.yaml и запустить их. Проверка сводится к docker compose version и docker compose ps с запущенным контейнером.
01Обновите систему и поставьте зависимости
Начните с обновления списка пакетов и установки утилит, которые нужны для скачивания ключа и работы apt по HTTPS. Пакет ca-certificates обеспечивает проверку TLS при обращении к репозиторию Docker.
sudo apt update
sudo apt install -y ca-certificates curl
02Добавьте ключ и репозиторий Docker
Ключ подписи кладётся в /etc/apt/keyrings, отдельный каталог для сторонних репозиториев. Затем в /etc/apt/sources.list.d/docker.list записывается строка репозитория с архитектурой и кодовым именем выпуска, которое подставляет $(. /etc/os-release && echo "$VERSION_CODENAME"). Для Ubuntu 24.04 это noble.
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
03Установите Docker Engine и плагин Compose
Пакет docker-compose-plugin даёт команду docker compose как подкоманду Docker CLI. Отдельный бинарник docker-compose из репозитория Ubuntu не нужен, версия из apt обычно устарела. После установки проверьте версии движка и плагина.
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version
docker compose version
04Разрешите запуск Docker без sudo
По умолчанию сокет /var/run/docker.sock доступен только root. Добавьте своего пользователя в группу docker и перезайдите в сессию, чтобы членство в группе применилось. Проверить можно командой docker ps без sudo.
sudo usermod -aG docker $USER
newgrp docker
docker ps
05Создайте файл compose.yaml
Проект описывается в файле compose.yaml в каталоге проекта, например /var/www/example.com. В примере два сервиса: app на образе nginx и db на MySQL 8 с томом для данных. Пароль передаётся через переменную окружения, для рабочего сервера храните его в .env рядом с файлом.
services:
app:
image: nginx:1.27
ports:
- "80:80"
depends_on:
- db
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: example_root_password
MYSQL_DATABASE: example_db
volumes:
- db_data:/var/lib/mysql
volumes:
db_data:
06Проверьте конфигурацию перед запуском
Команда docker compose config разбирает файл, подставляет переменные и выводит итоговый конфиг. Если в YAML ошибка отступов или неизвестный ключ, вы увидите сообщение об ошибке до запуска контейнеров. Запускайте её из каталога с compose.yaml.
cd /var/www/example.com
docker compose config
07Запустите сервисы
docker compose up -d скачивает образы, создаёт сеть и тома проекта и запускает контейнеры в фоне. Ключ -d возвращает управление в терминал, логи смотрите отдельно. Повторный запуск после правок в файле пересоздаёт изменившиеся контейнеры.
docker compose up -d
docker compose ps
08Проверьте работу и посмотрите логи
docker compose ps показывает состояние контейнеров проекта, колонка STATUS должна содержать Up. Логи сервиса app выводятся командой docker compose logs -f app, ключ -f держит поток открытым. Зайти в контейнер можно через docker compose exec app sh, остановить и удалить всё командой docker compose down.
docker compose ps
docker compose logs -f app
docker compose exec app sh
docker compose down
Частые ошибки
-
docker composeотвечаетcommand not found, хотя Docker установлен.Не установлен пакет
docker-compose-plugin. Поставьте его черезsudo apt install -y docker-compose-pluginи проверьтеdocker compose version. -
docker compose upпадает с ошибкойpermission denied while trying to connect to the Docker daemon socket.Пользователь не входит в группу
docker. Выполнитеsudo usermod -aG docker $USERи перезайдите в сессию, членство в группе не применяется к уже открытой оболочке. -
docker compose configругается на YAML:mapping values are not allowed in this contextилиdid not find expected key.Сломаны отступы: в YAML вложенность задаётся пробелами, табуляция запрещена. Выровняйте блоки двумя пробелами и снова запустите
docker compose config. -
Порт 80 занят,
docker compose upпишетbind: address already in use.Порт слушает другой процесс, часто системный nginx или apache2. Остановите его через
sudo systemctl stop nginxили смените публикацию порта вcompose.yaml, например на"8080:80".
Deploykin
Как это делается в Deploykin
В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем docker compose отличается от docker-compose?
docker compose это плагин Docker CLI из пакета docker-compose-plugin, актуальная версия Compose v2. docker-compose это отдельный бинарник v1, который больше не развивается, его синтаксис и команды отличаются.
Как обновить Docker Compose на Ubuntu 24.04?
Выполните sudo apt update и затем sudo apt install --only-upgrade docker-compose-plugin. Версию после обновления покажет docker compose version.
Где Docker Compose ищет файл конфигурации?
В текущем каталоге: compose.yaml или compose.yml, устаревшее имя docker-compose.yml тоже поддерживается. Другой файл указывается ключом -f, например docker compose -f /var/www/example.com/compose.yaml up -d.
Что делает docker compose down и удаляет ли он данные?
Останавливает и удаляет контейнеры и сеть проекта. Именованные тома сохраняются, база в томе db_data останется на месте. Ключ -v удаляет и тома, данные пропадут.
Как пересобрать образы после изменения Dockerfile?
Запустите docker compose build, затем docker compose up -d, чтобы пересоздать контейнеры на новых образах. Свежие базовые образы подтягивает docker compose pull.
Ещё по теме
- Руководство · 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 Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы