Telegram bot written in Go to manage Docker containers remotely. 25+ commands, multi-arch.
6.5K
Manage Docker from Telegram. Open-source bot written in Go — 25+ commands, real-time notifications, Docker Compose support, multi-arch image (amd64 + arm64).
🔗 GitHub · Landing · Issues
docker run -d \
--name botainer \
--restart unless-stopped \
-e TELEGRAM_BOT_TOKEN="your_token_here" \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
yoniergomez/botainer:latest
Get your token from @BotFather on Telegram.
services:
botainer:
image: yoniergomez/botainer:latest
container_name: botainer
restart: unless-stopped
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- /home/ubuntu:/workspace:ro
environment:
- TELEGRAM_BOT_TOKEN=your_token_here
- ALLOWED_USERS=123456789 # optional: restrict access by Telegram User ID
- HOST_HOME=/home/ubuntu # optional: for Compose project detection
- WORKSPACE=/workspace # optional: path to your Compose projects
network_mode: host
docker compose up -d
docker logs -f botainer
# → Bot started: @your_bot
| Variable | Required | Description |
|---|---|---|
TELEGRAM_BOT_TOKEN | ✅ | Bot token from @BotFather |
ALLOWED_USERS | ❌ | Comma-separated Telegram User IDs. Empty = allow all |
HOST_HOME | ❌ | Host home path (e.g. /home/ubuntu) |
WORKSPACE | ❌ | Path to Docker Compose projects directory |
| Category | Commands |
|---|---|
| Status | /start /list /ps /running /stats |
| Management | /restart /stop /pause /unpause /create |
| Logs | /logs /logfile |
| Images | /images /checkupdates /updateall |
| Compose | /compose |
| Resources | /volumes /networks /prune /search |
| Utilities | /exec /inspect /env /diagnose /favorites /history |
Commands are auto-registered in BotFather when the bot starts.
Once active, the bot sends alerts for:
Image updates are checked automatically every 6 hours.
| Architecture | Tag |
|---|---|
linux/amd64 | latest |
linux/arm64 | latest |
Built natively on GitHub Actions — no QEMU emulation.
Restrict access to specific users by setting ALLOWED_USERS:
-e ALLOWED_USERS=123456789,987654321
Get your Telegram User ID from @userinfobot.
| Tag | Description |
|---|---|
latest | Latest stable build |
{alpine}-go{go}-tgapi{tgapi} | Versioned build (e.g. 3.21.3-go1.24.2-tgapiv5.5.1) |
MIT — view license
Content type
Image
Digest
sha256:4873c4dc7…
Size
83.1 MB
Last updated
2 days ago
docker pull yoniergomez/botainer