# Bothost

> Хостинг Telegram-, Discord- и VK-ботов: деплой из Git, Docker, домены, переменные окружения. Документация для разработчиков и ИИ-ассистентов.

Bothost запускает боты в Docker-контейнерах. На части нод каталог `/app` при старте bind-mount'ится с кодом из Git — артефакты сборки (`dist/`) и бинарники в `/app` могут быть недоступны в runtime.

При ошибках деплоя (`MODULE_NOT_FOUND`, `restarting`, 502) сначала читайте справочник ошибок.

Полный текст документации одним файлом: https://bothost.ru/llms-full.txt
HTML-документация: https://bothost.ru/docs/

## Ошибки и troubleshooting

- [Справочник ошибок при деплое](https://bothost.ru/docs/common-errors): MODULE_NOT_FOUND (/app/index.js, dist/), nested-репозиторий, restarting, 502, Dockerfile, bind mount /app
- [Справочник ошибок при деплое (Markdown)](https://bothost.ru/docs/common-errors.md): тот же текст без HTML, удобно для LLM
- [Платёж не зачислился](https://bothost.ru/docs/check-payment): Как проверить оплату и активировать тариф вручную на странице «Мои платежи»
- [Платёж не зачислился (Markdown)](https://bothost.ru/docs/check-payment.md): тот же текст без HTML, удобно для LLM
- [FAQ](https://bothost.ru/docs/faq): Часто задаваемые вопросы и ответы
- [FAQ (Markdown)](https://bothost.ru/docs/faq.md): тот же текст без HTML, удобно для LLM

## Начало работы

- [Быстрый старт](https://bothost.ru/docs/getting-started): Создание первого бота на платформе Bothost
- [Быстрый старт (Markdown)](https://bothost.ru/docs/getting-started.md): тот же текст без HTML, удобно для LLM
- [Подключение приватного репозитория](https://bothost.ru/docs/git-repository-access): Приватный GitHub/GitLab: токены, SSH, deploy key и настройка в Bothost
- [Подключение приватного репозитория (Markdown)](https://bothost.ru/docs/git-repository-access.md): тот же текст без HTML, удобно для LLM
- [Ветка репозитория при деплое](https://bothost.ru/docs/repository-branch-deploy): Как выбрать ветку Git-репозитория (main, master, dev) при создании и деплое бота
- [Ветка репозитория при деплое (Markdown)](https://bothost.ru/docs/repository-branch-deploy.md): тот же текст без HTML, удобно для LLM
- [Работа с доменами и портами](https://bothost.ru/docs/domains-and-ports): Руководство по настройке доменов, пробросу портов и использованию адреса 0.0.0.0
- [Работа с доменами и портами (Markdown)](https://bothost.ru/docs/domains-and-ports.md): тот же текст без HTML, удобно для LLM

## Настройка

- [Переменные окружения](https://bothost.ru/docs/environment-variables): Список всех переменных окружения, доступных в контейнере бота
- [Переменные окружения (Markdown)](https://bothost.ru/docs/environment-variables.md): тот же текст без HTML, удобно для LLM
- [Веб-приложения и домены](https://bothost.ru/docs/web-apps-domains): Публикация веб-сервисов с доменом: HTTPS, вебхуки, порты, типичные ошибки
- [Веб-приложения и домены (Markdown)](https://bothost.ru/docs/web-apps-domains.md): тот же текст без HTML, удобно для LLM
- [Кастомный Dockerfile](https://bothost.ru/docs/custom-dockerfile): Как использовать свой Dockerfile для сборки и запуска бота или веб-приложения
- [Кастомный Dockerfile (Markdown)](https://bothost.ru/docs/custom-dockerfile.md): тот же текст без HTML, удобно для LLM
- [Главный файл (точка входа)](https://bothost.ru/docs/main-file-entrypoint): Как указать main file / entrypoint при деплое: автодетект, nested-папки, типичные ошибки
- [Главный файл (точка входа) (Markdown)](https://bothost.ru/docs/main-file-entrypoint.md): тот же текст без HTML, удобно для LLM
- [Хранение базы данных](https://bothost.ru/docs/database-storage): Хранение БД бота в /app/data для сохранения данных между обновлениями
- [Хранение базы данных (Markdown)](https://bothost.ru/docs/database-storage.md): тот же текст без HTML, удобно для LLM
- [Работа с SQLite через терминал](https://bothost.ru/docs/sqlite-terminal): Работа с SQLite через встроенный терминал дашборда
- [Работа с SQLite через терминал (Markdown)](https://bothost.ru/docs/sqlite-terminal.md): тот же текст без HTML, удобно для LLM
- [Установка библиотек: Python, Java и Go](https://bothost.ru/docs/installing-libraries): Как добавить зависимости для Python, Java и Go при деплое бота на Bothost
- [Установка библиотек: Python, Java и Go (Markdown)](https://bothost.ru/docs/installing-libraries.md): тот же текст без HTML, удобно для LLM
- [PDF из DOCX в Telegram-боте](https://bothost.ru/docs/libreoffice-pdf): LibreOffice headless на Bothost: конвертация документов в PDF через кастомный Dockerfile
- [PDF из DOCX в Telegram-боте (Markdown)](https://bothost.ru/docs/libreoffice-pdf.md): тот же текст без HTML, удобно для LLM

## Telegram

- [Telegram Userbot](https://bothost.ru/docs/telegram-userbot-setup): Настройка Telegram Userbot с использованием String Session
- [Telegram Userbot (Markdown)](https://bothost.ru/docs/telegram-userbot-setup.md): тот же текст без HTML, удобно для LLM
- [Mini App — Полное руководство](https://bothost.ru/docs/manual-mini-app): Создание Telegram Mini App на платформе BotHost с нуля
- [Mini App — Полное руководство (Markdown)](https://bothost.ru/docs/manual-mini-app.md): тот же текст без HTML, удобно для LLM

## API

- [REST API](https://bothost.ru/docs/api-reference): Полная документация по REST API платформы Bothost для разработчиков ботов
- [REST API (Markdown)](https://bothost.ru/docs/api-reference.md): тот же текст без HTML, удобно для LLM

## Optional

- [Сайт Bothost](https://bothost.ru/): главная страница продукта
- [Поддержка](https://t.me/bothostru): Telegram-поддержка
- [llms-full.txt](https://bothost.ru/llms-full.txt): все публичные статьи документации одним Markdown-файлом