https://github.com/t0mer/dockerbot

DockerBot is a Telepot powerd, easy to use Telegram bot written in python that runs as Docker Container.
https://github.com/t0mer/dockerbot

bot docker python telegram telegram-bot

Last synced: about 2 months ago
JSON representation

DockerBot is a Telepot powerd, easy to use Telegram bot written in python that runs as Docker Container.

• Host: GitHub
• URL: https://github.com/t0mer/dockerbot
• Owner: t0mer
• License: apache-2.0
• Created: 2020-07-09T21:33:36.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-06-10T22:46:39.000Z (7 months ago)
• Last Synced: 2024-11-01T07:51:49.839Z (2 months ago)
• Topics: bot, docker, python, telegram, telegram-bot
• Language: Python
• Homepage:
• Size: 1.47 MB
• Stars: 18
• Watchers: 1
• Forks: 10
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: License

Awesome Lists containing this project

• awesome-opensource-israel - Dockerbot - DockerBot is a Telepot powerd, easy to use Telegram bot written in python that runs as Docker Container.   (Projects by main language / python)

README

        
*Please :star: this repo if you find it useful*








# DockerBot

DockerBot is a [Telepot](https://telepot.readthedocs.io/en/latest/) powerd, easy to use Telegram bot written in python that runs as Docker Container.

With DockerBot you can:

- List Exsisting Containers (and get status).

- Start, Stop and Restart Containers.

- Run SpeedTest.

- Get Memory Status (Used, Free, etc.)

- Get Disk Status.

- Get Server Time.

- Get Server Real (External) IP.

#### Credits:

=======

- [Adam Russak](https://github.com/AdamRussak) for working with me on this project

## Usage

### Run from hub

#### docker-compose from hub

```yaml

version: "3.7"

services:

  dockerbot:

    image: techblog/dockerbot

    container_name: dockerbot

    network_mode: host

    cap_add:

       - NET_ADMIN

    privileged: true

    restart: always

    environment:

      - API_KEY=  #Required

      - ALLOWED_IDS= #Required

    volumes:

       - /var/run/docker.sock:/var/run/docker.sock

```

Replace API_KEY with your bot token. if you do not have existing bot you can create one

using the instruction in this article:

[Bots: An introduction for developers](https://core.telegram.org/bots) 

In order to secure the bot and block unwanted calls from Unauthorized users add your allowd Id's with comma separated values into ALLOWED_IDS

environmet. in order to get your id use @myidbot in telegram and send the /getid command. the result will be your ID:

[![Get your ID](https://github.com/t0mer/dockerbot/raw/master/screenshots/Idbot.PNG "Get your ID")](https://github.com/t0mer/dockerbot/raw/master/screenshots/Idbot.PNG "Get your ID")

# Screenshots

[![Get Containers List](https://github.com/t0mer/dockerbot/raw/master/screenshots/dockerbot_get_containers_list.PNG "Device Listing")](https://github.com/t0mer/dockerbot/raw/master/screenshots/dockerbot_get_containers_list.PNG "Device Listing")

[![Show Disk Info](https://github.com/t0mer/dockerbot/raw/master/screenshots/dockerbot_get_disk_info.PNG "Show Disk Info")](https://github.com/t0mer/dockerbot/raw/master/screenshots/dockerbot_get_disk_info.PNG "Show Disk Info")

[![Run Speed Test](https://github.com/t0mer/dockerbot/raw/master/screenshots/dockerbot_speedtest.PNG "Run Speed Test")](https://github.com/t0mer/dockerbot/raw/master/screenshots/dockerbot_speedtest.PNG "Run Speed Test")