Установка через Docker Compose

Это руководство описывает процесс установки и настройки TG Support Bot на виртуальном частном сервере (VPS) с использованием Docker Compose.

Предварительные требования

Перед началом убедитесь, что выполнены следующие условия:

• Есть VPS-сервер и зарегистрированный домен.
• На сервере установлены Docker и Docker Compose.
• Есть доступ к серверу по SSH.

Шаги установки и настройки

1. Регистрация VPS

Зарегистрируйте VPS-сервер на базе Ubuntu с предустановленным Docker Compose. Рекомендуемый объём оперативной памяти — не менее 1 ГБ.

Для хостинга я рекомендую использовать, например, Beget.

2. Настройка DNS

• Зарегистрируйте доменное имя.
• Направьте DNS-записи домена на IP-адрес вашего сервера.

TIP

Обновление DNS-записей обычно занимает 15–20 минут.

3. Подготовка окружения на сервере

Клонирование репозитория

Подключитесь к серверу по SSH и перейдите в директорию /home:

cd /home/

Создайте каталог для проекта и перейдите в него:

mkdir yourdomain.com && cd yourdomain.com

Клонируйте репозиторий. Точка в конце команды помещает файлы непосредственно в текущую директорию, без создания вложенной папки:

git clone https://github.com/prog-time/tg-support-bot.git .

Создание файла .env

Скопируйте шаблон конфигурации:

cp .env.example .env

Откройте файл .env и замените значения переменных на реальные данные:

1. Домен

MAIN_DOMAIN=example.com
APP_URL=https://example.com

2. Доступы к базе данных

DB_CONNECTION=pgsql
DB_HOST=pgdb
DB_PORT=5432
DB_DATABASE=database_name
DB_USERNAME=username
DB_PASSWORD=password

Параметры для настройки интеграций указываются в административной панели.

4. Запуск проекта

Убедитесь, что в файле .env указан параметр MAIN_DOMAIN — доменное имя, которое будет использоваться ботом и всеми его сервисами.

Запустите скрипт начальной настройки из корневой директории проекта:

./start.sh

Возникли проблемы?

Если при запуске start.sh что-то пошло не так, загляните в раздел «Типичные ошибки» или задайте вопрос в Telegram-сообществе - t.me/pt_tg_support.

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

1. Откройте браузер и перейдите на ваш домен.
2. Убедитесь, что страница открывается без ошибок и по протоколу HTTPS.
3. Откройте страницу https://{домен}/admin и убедитесь что форма авторизации работает корректно.

Создайте первого администратора с помощью artisan команды:

// Заходишь в контейнер
docker compose exec app bash

// Запускаешь команду
php artisan app:create-admin-user

Поздравляем

Бот успешно установлен и готов к работе. Теперь необходимо подключить интеграции в разделе "Настройки" -> "Интеграции".