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

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

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

```shell
    “The environment named Docker is unreachable”

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

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

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

```shell
    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:

```shell
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```

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

```shell
docker ps
docker logs portainer
```

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

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