Portainer: развертывание и решение ошибок подключения к Docker

Sat, 22 Nov 2025 19:00:00 +0300

Поделюсь опытом настройки Portainer — удобного веб-интерфейса для управления Docker. Столкнулся с типичными ошибками и нашел рабочие решения.

Типичные проблемы при запуске

1
2
3


    “The environment named Docker is unreachable”

    “client version 1.42 is too old. Minimum supported API version is 1.44”

Решения ошибки

Проверяем права доступа к Docker socket

1
2
3
4
5
6
7


    ls -l /var/run/docker.sock
    # Если не хватает прав:
    sudo chmod 666 /var/run/docker.sock
    # ИЛИ добавляем пользователя в группу docker
    sudo usermod -aG docker $USER
    # Перезагружаем сессию
    newgrp docker

Основная проблема

Основная проблема — несовместимость новых версий Docker Engine 29+ с некоторыми версиями Portainer.

Рабочий docker-compose.yml:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


services:
  portainer:
    image: portainer/portainer-ce:2.20.2  # Проверенная версия
    container_name: portainer
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./portainer-data:/data
    ports:
      - "9080:9080"
      - "9443:9443"

Важные моменты

Версия 2.20.2 стабильно работает с Docker 29+ Логи можно посмотреть: shell docker logs portainer

Проверка работоспособности:

1
2


docker ps
docker logs portainer

В браузере: https://сервер:9443