TG Selfhost Bot API

Self-hosted Telegram Bot API in Docker, built directly from the official tdlib server. Includes a webhook User-Agent patch and migration tools.

English docs · Документация на русском · Documentation website · Migration tool

Quick start

Requires Docker with Compose v2. Review the networking limitations before starting on a public host. Create .env and fill in API_ID / API_HASH:

cp .env.example .env
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

Local builds work before the first GHCR release. Once a published image is available, use docker compose pull && docker compose up -d. See installation for networking and verification.

• Official server source; independent Docker entrypoint.
• User-Agent: WebhookDelivery/1.0 on outgoing webhooks.
• Checked image builds and nightly upstream checks.
• Bash migration helper and browser-based migration planner.

The gateway binds to localhost by default and forwards file requests to the Bot API without exposing its state directory. See configuration before enabling external access.

Contributing · Issues