# Bothost

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

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

При ошибках деплоя (`MODULE_NOT_FOUND`, `restarting`, 502) сначала читайте справочник ошибок.
Если бот молчит или падает уже после успешной сборки, откройте статью по тексту ошибки: Conflict / Unauthorized / Discord offline, webhook 404 и SSL, ModuleNotFoundError, пропавшая SQLite, память и 429. Все они в разделе «Ошибки и troubleshooting».

Полный текст документации одним файлом: 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/bot-not-responding): Telegram bot stopped working, Conflict: terminated by other getUpdates request, can't use getUpdates while webhook is active, Unauthorized, aiogram не отвечает, Discord bot offline (4004, 4014)
- [Бот не отвечает (Markdown)](https://bothost.ru/docs/bot-not-responding.md): тот же текст без HTML, удобно для LLM
- [Webhook Telegram не работает](https://bothost.ru/docs/telegram-webhook-errors): Webhook 404 Not Found, SSL error, certificate verify failed, Connection timed out, pending_update_count, WEBHOOK_URL и обёртка /health на Bothost
- [Webhook Telegram не работает (Markdown)](https://bothost.ru/docs/telegram-webhook-errors.md): тот же текст без HTML, удобно для LLM
- [Локально работает, на сервере падает](https://bothost.ru/docs/works-locally-fails-on-server): bot works locally but not on server, ModuleNotFoundError, No module named, падение после деплоя, restarting, нет BOT_TOKEN и .env, неверный главный файл
- [Локально работает, на сервере падает (Markdown)](https://bothost.ru/docs/works-locally-fails-on-server.md): тот же текст без HTML, удобно для LLM
- [SQLite пропала после рестарта](https://bothost.ru/docs/sqlite-data-lost): SQLite database disappeared, bot loses data after restart: писать базу в /app/data (DATA_DIR), а не в /app/bot.db
- [SQLite пропала после рестарта (Markdown)](https://bothost.ru/docs/sqlite-data-lost.md): тот же текст без HTML, удобно для LLM
- [Память, timeout и лимиты API](https://bothost.ru/docs/bot-memory-timeout-rate-limits): Python bot memory leak, Killed и код 137, bot timeout, 429 Too Many Requests, retry_after. Лимиты памяти: бесплатный 256 МБ, Базовый 1 ГБ, Pro 2 ГБ
- [Память, timeout и лимиты API (Markdown)](https://bothost.ru/docs/bot-memory-timeout-rate-limits.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/upload-bot-archive): Деплой без Git: .zip и .tar.gz, кнопка на дашборде, мастер настройки и обновление архива
- [Загрузка бота из архива (Markdown)](https://bothost.ru/docs/upload-bot-archive.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-файлом