Установка

Установка Team Helper на сервер

Один хост, один Docker-стек. Образы Postgres, Redis и nginx уже внутри бандла — при установке интернет не нужен.

Редакция от 27 июля 2026

Требования

Linux с root/sudo — Ubuntu, Debian, RHEL и аналоги.
Docker и Docker Compose (docker compose или docker-compose).
Свободный порт 8080 (или другой — задайте HTTP_PORT до установки, см. Конфигурация).
Архитектура CPU совпадает с бандлом — обычно amd64 (uname -m).

Онлайн-установка (рекомендуется)

Скрипт скачивает релиз, проверяет SHA-256 и запускает установщик из бандла. Не pipe в root shell — сначала скачайте и просмотрите файл:

curl -fsSLO https://portal.helper-team.pro/dist/get.sh
sudo bash get.sh

Офлайн / air-gapped

Скопируйте helper-bundle-<version>.tar.gz и файл .sha256 на хост:

sudo bash get.sh --bundle ./helper-bundle-<version>.tar.gz

Либо распакуйте и запустите установщик напрямую:

tar xzf helper-bundle-<version>.tar.gz
cd helper-bundle-<version>
sudo ./install.sh

Что делает install.sh

Копирует стек в /opt/helper (или HELPER_INSTALL_DIR).
При первом запуске генерирует /opt/helper/.env с паролями и секретами. Повторный запуск не перезаписывает .env и данные.
Загружает образы из helper-images.tar (без обращения к registry).
Ставит CLI helper и systemd-юнит helper.service.
Поднимает контейнеры и печатает URL, админ-логин и отпечаток хоста.

Сохраните пароль администратора из вывода установщика — он же в HELPER_ADMIN_PASSWORD в .env.

Пример вывода

✓ Team Helper is running
  URL:      http://192.168.1.10:8080
  Админ:    admin@helper.local
  Пароль:   <сгенерированный пароль>
  Send this fingerprint to get a key:
    ac2bc19c972f531ad8973b7f9082052e

Архитектура стека

Сервис	Контейнер	Роль
nginx	helper-nginx	edge, единственный внешний порт (HTTP_PORT → 8080)
frontend	helper-frontend	Next.js SSR
web	helper-backend	Django/ASGI (API + WebSocket)
celery / celery-beat	helper-celery(-beat)	фоновые задачи и расписание
db / redis	helper-db / helper-redis	Postgres 16 и Redis (внутренние)

После установки

Активируйте лицензию — см. Лицензия.
Проверьте здоровье: helper doctor или helper health.
Автозапуск включается сам (helper.service); проверить — systemctl status helper.

TLS и reverse proxy

Team Helper отдаёт HTTP на HTTP_PORT. Для HTTPS поставьте перед ним nginx/Caddy/Traefik с сертификатом и проксируйте WebSocket. Подробнее — Конфигурация.