dedinit.ru/content/posts/20251122 Portainer install/index.md

title, date, draft, tags, categories, cover

title	date	draft	tags	categories	cover
Portainer: развертывание и решение ошибок подключения к Docker	2025-11-22T19:00:00+03:00	false	portainer docker selfhosting	selfhosting	image hero.svg

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

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

    “The environment named Docker is unreachable”

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

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

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

    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:

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

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

docker ps
docker logs portainer

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

Мне пришлось поменять версию чтобы Portainer заработал.