Перейти к основному содержимому

Установка YouGile Podman

В данном разделе описана установка и эксплуатация YouGile с использованием Podman.

Функциональность полностью соответствует Docker-версии, однако требует дополнительной настройки окружения для ручного использования podman-compose.

Системные требования​

Обязательные компоненты:

  • Podman (версия 4.0+) + podman-compose

Ресурсы сервера:

  • Минимум 2GB RAM (рекомендуется 4GB)
  • Минимум 5GB свободного места на диске
  • Порты 8080 и 8443 должны быть свободны

Для SSL (опционально):

  • Доменное имя, указывающее на ваш сервер
  • Доступ к DNS записям домена

Поддерживаемые операционные системы:

  • Linux (Ubuntu, Debian, CentOS, RHEL, Fedora, NixOS и др.)
  • macOS (x86_64)
  • Windows (с WSL2)

Установка​

Шаг 1: Скачайте установщик​

Скачайте исполняемый файл для вашей операционной системы:

Linux:

wget https://dist.yougile.com/docker/yougile-docker.zip
chmod +x yougile-docker

macOS:

curl -L https://dist.yougile.com/docker/yougile-docker.zip
chmod +x yougile-docker

Windows (в WSL2):

curl -L https://dist.yougile.com/docker/yougile-docker.zip
chmod +x yougile-docker

Шаг 2: Запустите установку​

./yougile-docker

Инструмент автоматически:

  • Определит доступный container runtime (Docker или Podman)
  • Настроит rootless Podman socket
  • Создаст структуру каталогов
  • Сгенерирует конфигурационные файлы
  • Запустит контейнеры

Шаг 3: Доступ к YouGile​

После успешной установки откройте браузер:

http://localhost:8080

Для HTTPS (после настройки SSL):

https://localhost:8443

Шаг 4: Первоначальная настройка​

  1. Отредактируйте ./yougile/conf.json - укажите ваш домен и SMTP настройки

  2. Перезапустите контейнеры:

    podman restart yougile nginx

  3. При необходимости настройте SSL сертификат

Поддержка Podman​

Инструмент автоматически определяет и поддерживает Podman:

  • Автодетект runtime - если команда docker является обёрткой над Podman (NixOS, Fedora), это определяется автоматически
  • Rootless режим - автоматическая настройка user socket для Podman
  • Порты без root - используются порты 8080/8443, не требующие привилегий

Требования для Podman​

Убедитесь что podman socket запущен:

systemctl --user start podman.socket
systemctl --user enable podman.socket

Установите podman-compose если нет встроенной поддержки:

pip install podman-compose

Настройка окружения для podman compose​

Бинарник yougile-docker автоматически настраивает DOCKER_HOST для себя. Но для ручного использования podman compose из терминала добавьте в ~/.bashrc или ~/.zshrc:

export DOCKER_HOST=unix:///run/user/$(id -u)/podman/podman.sock

Затем перезагрузите сессию:

source ~/.bashrc

или

source ~/.zshrc

Альтернатива: используйте команды podman напрямую:

podman ps                    # вместо podman compose ps
podman logs -f yougile       # вместо podman compose logs -f
podman restart nginx         # вместо podman compose restart nginx

Принудительный выбор runtime​

Если нужно явно указать runtime:

CONTAINER_RUNTIME=podman ./yougile-docker

Podman volumes:

  • yougile_database - база данных
  • yougile_userdata - пользовательские файлы
  • yougile_extensions - расширения

Дополнительные ресурсы​