Быстрый запуск

Начните с .env, затем поднимите Compose-стек и проверьте backend, worker и frontend.

Перед началом проверьте системные требования. Если подходящего сервера еще нет, его можно выбрать у друзей проекта — wCloud.

Минимальный запуск

Для нового сервера удобнее начать с интерактивного install wizard: он скачает нужный compose-профиль, соберет .env, проверит DNS, подготовит data/ и при необходимости запустит миграцию из Remnashop или старого remnawave-tg-shop. Подробности: интерактивный install wizard.

curl -fsSL https://gitlab.com/3252a8/remnawave-minishop/-/raw/main/scripts/install.sh -o install.sh
sh install.sh

В мастере Telegram ID и email первого владельца необязательны. Первый вход с совпавшей подтверждённой привязкой выдаст доступ в админку один раз. Если оба поля пропущены, после регистрации выполните из каталога установки docker compose exec backend python backend/scripts/bootstrap_owner.py --minishop-id ms_<id>, подставив ID из профиля. Это работает без привязанного Telegram/email. Если настройка Telegram и SMTP отложена, сначала настройте доступный способ регистрации. Подробности: первый владелец.

Ручной минимальный запуск из уже скачанного репозитория:

cp .env.example .env
nano .env
docker compose up -d --build
docker compose ps
docker compose logs -f backend worker frontend

Что заполнить в первую очередь

TELEGRAM_ENABLED=False для автономного режима; BOT_TOKEN нужен только при включённом Telegram. Необязательные BOOTSTRAP_OWNER_TELEGRAM_ID и BOOTSTRAP_OWNER_EMAIL назначают первого владельца при подтверждённом входе; без них доступна серверная команда по Minishop ID.
WEBHOOK_BASE_URL для платежных вебхуков и вебхуков панели (а также Telegram при его включении).
PUBLIC_APP_URL для кабинета и писем; SUBSCRIPTION_MINI_APP_URL остаётся совместимым алиасом.
EMAIL_AUTH_SECRET, SMTP_HOST и SMTP_FROM_EMAIL для входа по email.
POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB.
WEBAPP_SESSION_SECRET, WEBHOOK_SECRET_TOKEN, PANEL_API_URL, PANEL_API_KEY, PANEL_WEBHOOK_SECRET.

Если API панели доступен контейнерам по внутреннему адресу, дополнительно задайте PANEL_PUBLIC_URL — адрес панели для браузера администратора. Например, PANEL_API_URL=http://remnawave:3000/api и PANEL_PUBLIC_URL=https://panel.example.com. Install wizard ищет и предлагает оба адреса отдельно; без найденного публичного адреса его можно ввести вручную. См. настройки Remnawave.

Для вебхуков Remnawave в панели укажите WEBHOOK_URL как WEBHOOK_BASE_URL + /webhook/panel, например https://app.example.com/webhook/panel. Секрет создается или задается в Remnawave Panel; тот же секрет вставьте в PANEL_WEBHOOK_SECRET в .env или позже в Система -> Настройки -> Remnawave Panel.

Как выбрать Compose-вариант

Для продакшена по умолчанию берите Caddy: это самый короткий путь к публичному HTTPS без ручной раскладки сертификатов.

cd deploy/examples/caddy
cp .env.example .env
nano .env
docker compose up -d

Остальные варианты описаны в разделе развертывания:

Angie - если нужен автоматический HTTPS как у Caddy, но в Nginx-синтаксисе;
Nginx - если у вас уже есть TLS-сертификаты и нужен Nginx в Docker-сети;
Pangolin/Newt - если нельзя открывать входящие порты на сервере приложения;
без обратного прокси - для локальной проверки или внешнего TLS-терминатора.

Настройки для веб апп

Способы входа — email-код, email/пароль, Telegram, Google, Яндекс и passkey.

После первого входа

Откройте админку через Mini App.
Проверьте платежные методы в настройках.
Настройте каталог тарифов.
Проверьте инструкции подключения.
Сделайте тестовую покупку или пробную активацию.

Подробности: настройка окружения и развертывание.