Установка Docker и Docker Compose на Ubuntu 24.04
Docker ставится из официального репозитория Docker пакетами docker-ce и docker-compose-plugin. Compose v2 работает как плагин, команда пишется через пробел: docker compose. После установки вы запустите тестовый проект и проверите, что контейнеры видят друг друга по имени сервиса.
01Установите Docker из репозитория Docker
Удалите старые пакеты, если они есть, и поставьте зависимости для подключения репозитория по HTTPS. Затем добавьте ключ и репозиторий Docker для Ubuntu 24.04 (кодовое имя noble).
sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu noble stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
02Установите пакеты Docker и плагин Compose
Пакет docker-compose-plugin даёт команду docker compose. Отдельный бинарник docker-compose из версии v1 не нужен и с 2023 года не поддерживается. Проверьте версии после установки.
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version
docker compose version
03Разрешите запуск docker без sudo
Добавьте пользователя в группу docker и войдите заново, чтобы группа применилась. Членство в группе docker даёт права root на сервере, поэтому добавляйте только доверенных пользователей.
sudo usermod -aG docker $USER
newgrp docker
04Создайте compose.yaml для тестового проекта
Создайте каталог проекта и файл compose.yaml. В Compose v2 ключ version: устарел и вызывает предупреждение, поэтому его не пишут. Сервис app обращается к базе по имени сервиса db, а не по localhost.
services:
app:
image: nginx:1.24
ports:
- "127.0.0.1:8080:80"
depends_on:
- db
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: example
MYSQL_DATABASE: app
volumes:
- db_data:/var/lib/mysql
volumes:
db_data:
05Проверьте конфигурацию и запустите проект
Команда docker compose config проверяет YAML и печатает итоговый конфиг, ошибки отступов видны сразу. Затем запустите сервисы в фоне и посмотрите их состояние.
docker compose config
docker compose up -d
docker compose ps
06Проверьте работу контейнеров
Откройте опубликованный порт и загляните в логи. Из контейнера app база доступна как db:3306. Если порт 8080 занят, docker compose up -d завершится ошибкой Bind for 0.0.0.0:8080 failed: port is already allocated.
curl -I http://127.0.0.1:8080
docker compose logs -f app
docker compose exec app sh -c 'getent hosts db'
Частые ошибки
-
При запуске docker появляется permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.
Пользователь не в группе docker или не перелогинился после usermod. Выполните sudo usermod -aG docker $USER и войдите в систему заново.
-
docker compose up -d падает с ошибкой Bind for 0.0.0.0:80 failed: port is already allocated.
Порт на хосте занят nginx самого сервера или другим контейнером. Найдите процесс командой sudo ss -ltnp и освободите порт или измените публикацию в compose.yaml.
-
docker compose пишет no configuration file provided: not found.
В текущем каталоге нет compose.yaml или docker-compose.yml. Перейдите в каталог проекта или укажите путь через docker compose -f /path/to/compose.yaml up -d.
-
В контейнере не удаётся записать в смонтированный каталог: Permission denied.
UID пользователя в контейнере не совпадает с владельцем каталога на хосте. Подберите владельца каталога под пользователя в образе, например для php на Debian это UID 33.
Deploykin
Как это делается в Deploykin
В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем отличается docker compose от docker-compose?
Docker Compose v2 это плагин, команда пишется через пробел: docker compose. Старый бинарник docker-compose версии v1 не поддерживается с 2023 года.
Нужно ли указывать version в compose.yaml?
Нет. В Compose v2 ключ version: устарел и вызывает только предупреждение. Файл по умолчанию называется compose.yaml, старое имя docker-compose.yml тоже читается.
Как обратиться к базе из другого контейнера?
По имени сервиса в сети проекта. Из контейнера app база db доступна как db:3306, а не как localhost.
Сохранятся ли данные после docker compose down?
Именованные тома переживают docker compose down. Удаляет их только docker compose down -v.
Что значит код выхода 137?
Процесс убит сигналом SIGKILL, чаще всего из-за нехватки памяти. Проверьте потребление памяти контейнером и лимиты на сервере.
Ещё по теме
- Руководство · Docker docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · 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 Установка Docker Engine на Ubuntu 24.04 Установите Docker Engine и Compose v2 на Ubuntu 24.04 из официального репозитория: команды, настройка без sudo, проверка контейнером hello-world.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы