Add new post about setuid bits

content/posts/20251122 Portainer install/index.md

@@ -0,0 +1,67 @@
+---
+title: "Portainer: развертывание и решение ошибок подключения к Docker"
+date: 2025-11-22T19:00:00+03:00
+draft: false
+tags: ["portainer", "docker", "selfhosting"]
+categories: ["selfhosting"]
+---
+
+Поделюсь опытом настройки 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 заработал.