DockeGram is a Telegram bot that allows you to manage Docker containers directly through Telegram messages. With DockeGram, you can start, stop, restart containers, view logs, and monitor container status, all from your Telegram app.

• Start, stop, and restart Docker containers
• View container logs
• List all containers with their current status
• Check if specific containers exist
• Automatic monitoring of container status with alerts for unexpected stops
• User authentication to restrict access to authorized users only

• Docker installed on your host machine
• Telegram Bot Token (obtained from BotFather)
• Telegram User ID of authorized users

1. Open Telegram and search for @BotFather
2. Start a chat with BotFather and send the command /newbot
3. Follow the instructions to create your bot
4. Once created, BotFather will provide you with a token. Save this token for later use.

1. Send a message to @userinfobot on Telegram
2. The bot will reply with your User ID and other information

version: '3.9'

services:
  dockergram:
    image: gdagtekin/dockegram:latest
    container_name: dockegram
    restart: unless-stopped
    environment:
      - TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN
      - ALLOWED_USER_IDS=YOUR_USER_ID
      - ENABLE_MONITORING=True
      - MONITORING_INTERVAL=300
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

docker compose up -d

docker run -d \
  --name dockegram \
  --restart unless-stopped \
  -e TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN \
  -e ALLOWED_USER_IDS=YOUR_USER_ID \
  -e ENABLE_MONITORING=True \
  -e MONITORING_INTERVAL=300 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  gdagtekin/dockegram:latest

docker logs -f dockegram

git clone https://github.com/gdagtekin/dockegram.git
cd dockegram

docker build -t dockegram .

docker run -d \
  --name dockegram \
  --restart unless-stopped \
  -e TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN \
  -e ALLOWED_USER_IDS=YOUR_USER_ID \
  -e ENABLE_MONITORING=True \
  -e MONITORING_INTERVAL=300 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  dockegram

docker logs -f dockegram

You can configure Dockegram using the following environment variables:

Dockegram supports two command formats:

• /start_container_name - Start a container
• /stop_container_name - Stop a container
• /restart_container_name - Restart a container
• /logs_container_name - Show last 10 logs from a container

• /start container_name - Start a container
• /stop container_name - Stop a container
• /restart container_name - Restart a container
• /logs container_name - Show last 10 logs from a container
• /check container_name - Check if a container exists

• /list - List all containers with clickable command links
• /help - Show help message
• /info - Show information about the bot environment

• To start a container named "nginx": /start_nginx or /start nginx
• To stop a container: /stop_nginx or /stop nginx
• To view container logs: /logs_nginx or /logs nginx
• To list all containers: /list

When ENABLE_MONITORING is set to True, Dockegram will periodically check the status of all containers. If a container stops unexpectedly (not manually stopped through the bot), Dockegram will send an alert message to all authorized users.

• The bot only allows commands from users listed in ALLOWED_USER_IDS
• The Docker socket is mounted into the container, which gives the bot full control over your Docker environment
• Only give access to users you trust with full Docker control

Distributed under the AGPLv3 License. See LICENSE.md for more information.

Developed by Gökhan Dağtekin