Типовые ошибки
Почти всегда ответ есть в логе: лог сборки — во вкладке «Сборки», журнал бота — во вкладке «Логи». Строка с ✗ в конце лога сборки говорит, на чём она остановилась.
ModuleNotFoundError: No module named '…'
Бот импортирует библиотеку, которой нет в requirements.txt (или в pyproject.toml). В контейнер устанавливается только то, что там перечислено. Добавьте пакет, закоммитьте и запустите сборку заново. Для Node.js то же самое с package.json (Cannot find module): зависимость должна быть в dependencies, а не только в devDependencies — установка идёт с --omit=dev.
Conflict: terminated by other getUpdates request
Этот же токен используется где-то ещё: бот запущен локально, на другом хостинге или в двух ботах AutoHoster одновременно. Telegram отдаёт обновления только одному процессу. Остановите второй экземпляр. Если непонятно, где он запущен, — отзовите токен в @BotFather (/revoke), вставьте новый в параметрах бота и нажмите «Применить настройки».
Бот «Остановлен» или «Ошибка» сразу после сборки
Образ собрался, но процесс завершился в первые секунды. Платформа ждёт 4 секунды, и если контейнер не работает, помечает сборку ошибкой «Бот не запустился» и дописывает последние строки журнала бота в лог сборки. Типичные причины:
- не хватает переменной окружения (
KeyError: 'ADMIN_ID') — добавьте её в «Настройках» и нажмите «Применить настройки»; - неверный токен в коде вместо переменной
TELEGRAM_BOT_TOKEN; - бот запускается в режиме webhook (см. ниже);
- скрипт выполняет работу и выходит — бот должен работать бесконечно (polling), а не завершаться.
Если на табло «Перезапуск» — процесс падает циклически; причина та же, смотрите журнал.
Нехватка памяти (OOM)
Контейнер получает столько памяти, сколько даёт тариф (128 МБ на «Пробном»). Если бот превышает лимит, система его завершает — в журнале обрыв без traceback, бот уходит в «Перезапуск». Что делать: не загружать большие файлы целиком в память, не держать тяжёлые библиотеки (например, pandas/torch) ради простой задачи, или перейти на тариф с большей памятью. Графики памяти — на странице бота.
Приватный репозиторий: Repository not found / 404
Для приватного репозитория платформе нужен токен GitHub: fine-grained token с правом *Contents: Read-only* на этот репозиторий. Укажите его в параметрах бота. Проверьте также, что ветка существует: клонируется именно та ветка, что указана в параметрах (git clone: ... Remote branch … not found).
Неверный токен
«Telegram отклонил токен» — проверьте, что скопировали всю строку 123456789:AAH... без пробелов, и что токен не отозван в @BotFather. «Telegram недоступен, попробуйте позже» — временная сетевая ошибка, повторите через минуту.
Polling vs webhook
Контейнеры AutoHoster не принимают входящих соединений, поэтому режим webhook (setWebhook, run_webhook, app.run_webhook) не работает. Бот должен использовать long polling: getUpdates, в библиотеках — run_polling(), executor.start_polling(), bot.polling(), dp.start_polling().
Если раньше для этого токена был установлен webhook, polling отвечает ошибкой Conflict: can't use getUpdates method while webhook is active. Снимите его один раз: откройте в браузере https://api.telegram.org/bot<ТОКЕН>/deleteWebhook или вызовите delete_webhook() при старте бота.
Бот молчит, в журнале Connection to api.telegram.org timed out
Варианты той же ошибки: ConnectTimeoutError, Read timed out, ETIMEDOUT, ServerDisconnectedError при запросе к api.telegram.org. Контейнер работает, а ответов нет.
Причина: серверы AutoHoster в России не достают до api.telegram.org напрямую — соединение висит до таймаута. Поэтому платформа ходит в Telegram через свой релей и передаёт его адрес боту в переменной TELEGRAM_API_BASE. Если бот работает на сервере за рубежом, переменная пустая, и подключаться нужно напрямую.
Ботам на Python (aiogram, pyTelegramBotAPI, python-telegram-bot) платформа подставляет релей сама — после новой сборки, если бот не указал свой адрес API. Если ошибка осталась или бот написан на Node.js или ходит в Bot API своими запросами, прочитайте переменную в коде.
Правило одно: адрес API = TELEGRAM_API_BASE, а если она пустая — https://api.telegram.org.
pyTelegramBotAPI (telebot) — до создания TeleBot:
import os
from telebot import apihelper
base = os.environ.get("TELEGRAM_API_BASE", "").rstrip("/")
if base:
apihelper.API_URL = base + "/bot{0}/{1}"
apihelper.FILE_URL = base + "/file/bot{0}/{1}"
aiogram 3:
from aiogram.client.session.aiohttp import AiohttpSession
from aiogram.client.telegram import TelegramAPIServer
base = os.environ.get("TELEGRAM_API_BASE", "").rstrip("/")
session = AiohttpSession(api=TelegramAPIServer.from_base(base)) if base else None
bot = Bot(token, session=session)
python-telegram-bot 20+:
base = os.environ.get("TELEGRAM_API_BASE", "").rstrip("/") or "https://api.telegram.org"
app = ApplicationBuilder().token(token).base_url(base + "/bot").base_file_url(base + "/file/bot").build()
Node.js: Telegraf — new Telegraf(token, { telegram: { apiRoot: process.env.TELEGRAM_API_BASE || "https://api.telegram.org" } }); node-telegram-bot-api — опция baseApiUrl с тем же значением.
Свои запросы к Bot API (requests, httpx, fetch) собирайте от той же базы: f"{base}/bot{token}/sendMessage". Не прописывайте api.telegram.org в коде, не ставьте прокси и не закрепляйте IP Telegram в hosts. После правки закоммитьте и запустите сборку заново.
«Не удалось определить точку входа»
Платформа ищет bot/__main__.py, app/__main__.py, затем main.py, bot.py, app.py, run.py в корне. Если файл называется иначе или лежит в подпапке — укажите команду запуска в параметрах бота (например, python src/main.py) или добавьте Dockerfile.
«Не найден ни Dockerfile, ни requirements.txt/pyproject.toml, ни package.json»
В корне репозитория нет файла, по которому можно понять язык. Добавьте requirements.txt (Python) или package.json (Node.js), либо свой Dockerfile.
Сборка идёт слишком долго или прервана
На сборку отводится 15 минут и 1 ГБ памяти. Чаще всего время уходит на установку тяжёлых зависимостей — уберите лишнее из requirements.txt. Параллельно на сервере собирается не больше двух ботов, так что сборка может немного подождать в очереди.
«Аккаунт ожидает подтверждения администратором»
На платформе включена модерация новых аккаунтов: добавить бота можно, но сборка и запуск заработают после одобрения. Напишите в поддержку, если ждёте долго.
Ничего не помогло
Напишите в поддержку через чат-ассистента (кнопка «Передать человеку») или создайте обращение в разделе «Поддержка» кабинета. Приложите название бота и последние строки лога — так ответ будет быстрее.