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

Установка Docker Engine на Ubuntu 24.04

Docker Engine ставят из официального репозитория Docker пакетами docker-ce и docker-ce-cli, вместе с containerd.io и плагинами buildx и compose. После установки пользователя добавляют в группу docker, чтобы команды работали без sudo. Проверка: контейнер hello-world и вывод docker compose version.

Руководство Docker 3 мин чтения

01Обновите систему и установите зависимости

На чистом сервере обновите список пакетов и поставьте утилиты, которые нужны для подключения репозитория по HTTPS. Пакет ca-certificates обязателен, иначе apt не сможет проверить подпись репозитория Docker.

bash
sudo apt update
sudo apt install -y ca-certificates curl gnupg

02Добавьте официальный GPG-ключ Docker

Ключ подписывает пакеты репозитория. Создайте каталог для ключей, скачайте ключ и сохраните его в отдельный файл в бинарном формате. Этот файл apt будет использовать при проверке пакетов docker-ce.

bash
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

03Подключите репозиторий Docker

Репозиторий указывает apt, откуда брать пакеты Docker. Архитектуру и кодовое имя выпуска подставьте через переменные, чтобы команда работала на amd64 и arm64. Для Ubuntu 24.04 кодовое имя noble.

bash
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] 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

04Установите Docker Engine и плагины

Пакет docker-ce содержит демон, docker-ce-cli клиент, containerd.io среду выполнения контейнеров. Плагины docker-buildx-plugin и docker-compose-plugin дают команды docker buildx и docker compose. Старые пакеты docker.io и docker-compose из репозитория Ubuntu лучше не ставить вместе с этими.

bash
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

05Разрешите запуск docker без sudo

По умолчанию сокет /var/run/docker.sock принадлежит root, и обычный пользователь получает ошибку permission denied. Добавьте себя в группу docker и войдите в систему заново, чтобы группа применилась. Членство в группе docker даёт права root на сервере, поэтому добавляйте только доверенных пользователей.

bash
sudo usermod -aG docker $USER

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

Перезайдите по SSH и выполните проверочный контейнер. Команда docker run hello-world скачает образ и запустит его, в выводе будет строка Hello from Docker. Версия Compose должна быть v2, команда пишется через пробел: docker compose version.

bash
docker run hello-world
docker compose version
docker info

Частые ошибки

  • После usermod команда docker выдаёт permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.

    Группа применилась только к новым сессиям. Выйдите из SSH и зайдите снова, затем проверьте вывод id -nG: в списке должна быть docker.

  • Порт 80 занят, контейнер не стартует с ошибкой Bind for 0.0.0.0:80 failed: port is already allocated.

    Порт держит nginx самого сервера или другой контейнер. Найдите процесс командой sudo ss -ltnp и остановите его либо опубликуйте порт контейнера на другом порту хоста.

  • docker compose up -d завершается с no configuration file provided: not found.

    В текущем каталоге нет compose.yaml или docker-compose.yml. Перейдите в каталог проекта или укажите путь через docker compose -f /path/compose.yaml up -d.

  • Compose падает с yaml: line 12: did not find expected key.

    Ошибка в отступах или кавычках рядом с указанной строкой. Отступы делайте пробелами, не табуляцией, и проверьте файл командой docker compose config.

Deploykin

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

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

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

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

Чем docker.io отличается от docker-ce?

docker.io это пакет из репозитория Ubuntu, обычно более старая версия. docker-ce ставят из официального репозитория Docker, он обновляется быстрее и идёт вместе с плагинами buildx и compose.

Почему команда docker-compose не работает?

Docker Compose v1 с дефисом не поддерживается с 2023 года. В Compose v2 это плагин, и команда пишется через пробел: docker compose.

Как проверить, что Docker Engine запущен?

Выполните docker info: команда покажет версию сервера, драйвер хранилища и число контейнеров. Если демон не отвечает, проверьте статус службы командой systemctl status docker.

Нужно ли добавлять пользователя в группу docker?

Без этого каждая команда docker требует sudo. Группа docker даёт права root на сервере, поэтому добавляйте в неё только тех, кому доверяете администрирование.

Ещё по теме

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

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