Установка Docker Engine на Ubuntu 24.04
Docker Engine ставят из официального репозитория Docker пакетами docker-ce и docker-ce-cli, вместе с containerd.io и плагинами buildx и compose. После установки пользователя добавляют в группу docker, чтобы команды работали без sudo. Проверка: контейнер hello-world и вывод docker compose version.
01Обновите систему и установите зависимости
На чистом сервере обновите список пакетов и поставьте утилиты, которые нужны для подключения репозитория по HTTPS. Пакет ca-certificates обязателен, иначе apt не сможет проверить подпись репозитория Docker.
sudo apt update
sudo apt install -y ca-certificates curl gnupg
02Добавьте официальный GPG-ключ Docker
Ключ подписывает пакеты репозитория. Создайте каталог для ключей, скачайте ключ и сохраните его в отдельный файл в бинарном формате. Этот файл apt будет использовать при проверке пакетов docker-ce.
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.
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 лучше не ставить вместе с этими.
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 на сервере, поэтому добавляйте только доверенных пользователей.
sudo usermod -aG docker $USER
06Проверьте установку
Перезайдите по SSH и выполните проверочный контейнер. Команда docker run hello-world скачает образ и запустит его, в выводе будет строка Hello from Docker. Версия Compose должна быть v2, команда пишется через пробел: docker compose version.
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 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: руководство по работе с многоконтейнерными приложениями: все материалы темы