Open Source · Written in Go

Docker in your
pocket.

Telegram bot to manage Docker containers from anywhere. 25+ commands, real-time notifications, Docker Compose, remote image tracking, Helm chart monitoring.

⭐ View on GitHub → Quick install
botainer — telegram
@mybot /ps
🐳 Running containers (4)
━━━━━━━━━━━━━━━━━━━━━━━━━━━
● 🐘 postgres CPU 0.2% RAM 128MB
● 🔴 redis CPU 0.0% RAM 12MB
● 🟢 nginx CPU 0.1% RAM 18MB
● 🍃 mongo CPU 0.0% RAM 64MB ⚠

@mybot /diagnose
✓ 3 containers healthy
✗ mongo: unhealthy — check logs

@mybot
25+
Commands
40+
Icons
~20MB
RAM
<1s
Response
Go
Language
01 — Features

Everything you need
to manage Docker.

From real-time monitoring to step-by-step container creation.

📊

Real-time monitoring

CPU, RAM and healthchecks for every container with instant updates.

🔔

Automatic notifications

Alerts on start, stop, restart and pause — zero extra configuration.

🆕

Smart update detection

Detects digest updates AND newer semver tags. One-click update for compose services and standalone containers.

📁

Full Docker Compose

Up, Down, Restart, Pull and PS per project with auto-detection.

🛠️

Create containers

Step-by-step wizard for Docker Run and Compose. Generates the command or YAML ready to use.

📜

Advanced logs

Error highlighting, filters, refresh and download as .log file.

🔧

Auto diagnostics

Detects stopped containers, unhealthy status, high CPU and unused images.

🔍

Universal search

Search across containers, images and volumes with a single command.

📡

Remote image tracking

Monitor Docker images from any registry (Docker Hub, GHCR, private) for updates.

📦

Helm chart monitoring

Track Helm charts from Artifact Hub and get notified of new versions.

⚠️

Resource alerts

Configure CPU/RAM/Disk thresholds and receive instant alerts.

🏥

Health checks

HTTP/TCP health checks with automatic notifications on failure.

📋

Audit logs

Complete command history with user tracking and export capability.

🔒

Vulnerability scanning

Scan images with Trivy and get CVE reports instantly.

↩️

Rollback system

Save previous image versions and rollback with one click.

📋

Container templates

Save and deploy container configurations as reusable templates.

🔧

Maintenance mode

Pause all containers except critical ones for system maintenance.

🌐

Network management

Create, inspect and delete Docker networks with full visibility.

🧹

Intelligent cleanup

Detect orphaned images and free up disk space automatically.

🔌

Port management

View all exposed ports and detect conflicts instantly.

🔗

Webhooks

Send events to external services (Slack, Discord, custom endpoints).

⚙️

Update policies

Schedule updates and set resource requirements for auto-updates.

📊

Scheduled reports

Daily or weekly system reports delivered automatically.

⭐

Favorites

Quick access to your most-used containers, persistent per user.

02 — Commands

40+ commands ready
to use.

Auto-registered in BotFather when the bot starts.

Basic
  • /start
  • /list
  • /ps
  • /running
  • /stats
Management
  • /restart
  • /stop
  • /pause
  • /unpause
  • /create
Advanced
  • /compose
  • /exec
  • /inspect
  • /search
  • /env
Resources
  • /images
  • /volumes
  • /networks
  • /prune
  • /ports
Tracking
  • /trackimage
  • /trackchart
  • /checkupdates
Monitoring
  • /alerts
  • /healthchecks
  • /reports
Security
  • /audit
  • /scan
  • /webhooks
  • /policies
Advanced
  • /rollback
  • /templates
  • /maintenance
  • /cleanup
  • /registries
Utilities
  • /favorites
  • /history
  • /diagnose
03 — Mini App

Visual dashboard
inside Telegram.

Compact UI with 40% more information density. Works on all devices.

🎨 Compact Design

  • ✓ 40% more information density — see more containers at once
  • ✓ Hamburger menu — all options in one place
  • ✓ Inline search + filters — quick access to what you need
  • ✓ Compact cards — reduced padding, smaller text, better layout
  • ✓ Responsive — works on phone, tablet, and desktop

⚡ Quick Actions

📊 Stats
Real-time CPU/RAM
📈 Charts
Historical metrics
📋 Logs
Color-coded output
🔍 Inspect
Full JSON details
🔄 Restart
One-tap restart
🗑️ Delete
With confirmation

🚀 Advanced Features

  • ✓ Bulk operations — select multiple containers for batch actions
  • ✓ Docker Compose — manage all your projects in one place
  • ✓ Network visualizer — see topology and connections
  • ✓ Alerts system — CPU/RAM thresholds with Telegram notifications
  • ✓ Multi-user — role-based access (Admin, Operator, Viewer)
  • ✓ Template library — save and deploy configurations

Access from Telegram:

/start → 🐳 Dashboard
04 — Installation

Up and running
in 3 steps.

All you need is Docker, Docker Compose and a Telegram token.

01

Clone the repository

Download the project to your Linux server.

02

Set your token

Copy the example file and add your token from @BotFather.

03

Start the bot

Docker builds the image and starts the container automatically.

# Option A: Pre-built image (Docker Hub) docker pull yoniergomez/botainer:latest # Option B: Pre-built image (GitHub Container Registry) docker pull ghcr.io/yoniergomez/botainer:latest # Option C: Build from source git clone https://github.com/YonierGomez/botainer.git cd botainer # Set token cp .env.example .env # Edit .env → TELEGRAM_BOT_TOKEN=your_token # Start docker compose up -d --build docker logs -f botainer # → Bot started: @your_bot
04 — CI/CD

Automated
multi-arch build.

Weekly pipeline that detects new Alpine versions and publishes images for amd64 and arm64 without QEMU.

Docker Multi-Arch CI

The workflow runs every Monday at 08:00 UTC. It compares the Alpine version against the latest release and, if there are changes, builds on native runners, merges the multi-arch manifest and creates a GitHub Release with a changelog.

CI Pulls Release Stars
Step 1check-version
→
Step 2build amd64
→
Step 2build arm64
→
Step 3merge manifest
→
Step 4release