Гайд: Установка Docker и Docker Compose в ALT Linux: пошаговое руководство по настройке

Подробное руководство по установке и настройке Docker и Docker Compose в ALT Linux. Разбор команд, управление правами, запуск сервисов и решение типовых ошибок.

2026.05.12                  


Гайд: Установка Docker и Docker Compose в ALT Linux: пошаговое руководство по настройкеГайд: Установка 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.

Удачной работы с контейнерами!