Гайд: Установка Docker и Docker Compose в ALT Linux: пошаговое руководство по настройке
Ниже приведён подробный, актуальный для ALT Linux (p10/p11) гайд по установке Docker и Docker Compose без декоративных элементов.
1. Подготовка системы
ALT Linux использует пакетный менеджер apt (на базе apt-rpm), поэтому синтаксис похож на Debian/Ubuntu, но под капотом работают RPM-пакеты.
# Обновите кэш и установленные пакеты
sudo apt update
sudo apt upgrade -y
2. Установка Docker
В репозиториях ALT Linux уже есть стабильные пакеты Docker.
sudo apt install docker
После установки проверьте версию:
docker --version
# Пример вывода: Docker version 24.x.x, build ...
3. Установка Docker Compose
Существует два пути:
Способ A: Через официальный репозиторий ALT (рекомендуется)
sudo apt install docker-compose
Примечание:
В современных версиях Docker Compose v2 распространяется как плагин CLI.
Пакет docker-compose в ALT Linux обычно устанавливает оба варианта:
docker-compose(классическая v1, для обратной совместимости)docker compose(v2, вызывается через пробел, работает быстрее и активнее развивается)
Способ B: Установка актуальной v2-версии вручную (если в репозитории устаревшая)
Если вам нужна самая свежая версия или пакет в репозитории не содержит v2-плагин:
# Создаём директорию для плагина (если её нет)
sudo mkdir -p /usr/local/lib/docker/cli-plugins
# Скачиваем последнюю версию (замените VERSION на актуальную, например v2.29.0)
# Список релизов: https://github.com/docker/compose/releases
VERSION="v2.29.0"
sudo curl -SL "https://github.com/docker/compose/releases/download/${VERSION}/docker-compose-linux-$(uname -m)" \
-o /usr/local/lib/docker/cli-plugins/docker-compose
# Делаем исполняемым
sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
# Проверяем
docker compose version
4. Настройка сервиса и прав
Включите и запустите Docker
sudo systemctl enable --now docker
Проверьте статус:
systemctl status docker
# Должно быть: Active: active (running)
Дайте вашему пользователю доступ к Docker без sudo
По умолчанию только root может управлять демоном Docker.
sudo usermod -aG docker $USER
Важно:
Чтобы изменения вступили в силу, нужно перезайти в систему (log out / log in)
или выполнить:
newgrp docker
После этого команды docker и docker compose будут работать без sudo.
5. Проверка работы
Создайте тестовый файл docker-compose.yml:
version: "3.8"
services:
test:
image: hello-world
Запустите:
docker compose up
Если всё корректно, вы увидите сообщение Hello from Docker!.
6. Типичные проблемы в ALT Linux и их решение
| Проблема | Причина | Решение |
|---|---|---|
Cannot connect to the Docker daemon |
Сервис не запущен или нет прав | sudo systemctl start docker + добавьте пользователя в группу docker |
Permission denied while connecting to Docker daemon socket |
Не вышли из системы после usermod |
Перезайдите в сессию или выполните newgrp docker |
iptables/nftables: COMMAND_FAILED |
Конфликт файрвола | ALT по умолчанию может использовать firewalld или iptables. Разрешите трафик: sudo firewall-cmd --add-service=docker --permanent && sudo firewall-cmd --reload (если используется firewalld) |
Error response from daemon: failed to create endpoint |
Сетевой конфликт в контейнерах | Остановите конфликтующие сети или выполните sudo systemctl restart docker |
Пакет docker-compose не найден |
Репозиторий не подключён или устарел | Обновите систему sudo apt update, проверьте apt policy docker-compose. При необходимости используйте ручной способ установки плагина. |
Дополнительно
- Документация Docker Compose: docs.docker.com/compose/
- Репозитории ALT Linux: packages.altlinux.org
- В ALT Linux p11 используется ядро 6.x и systemd, поэтому все команды
systemctlработают штатно. - Если вы используете ALT Workstation/Server с включённым SELinux, Docker обычно работает без дополнительных правок, но при проблемах с монтированием томов проверьте логи
journalctl -u dockerи при необходимости установитеsetroubleshoot.
Удачной работы с контейнерами!