mrmarble/teledock

By mrmarble

Updated about 3 years ago

Image
2

9.1K

Teledock

GolangQuality Gate StatusGitHub go.mod Go versionGo Report CardDocker Pulls

Teledock: A simple telegram bot that allows a telegram's user to control a docker service.

Features

  • List containers
  • Start / Stop containers
  • Inspect containers
  • List stacks
  • See logs
  • List images

Build

go build

Running it

Requirements
Configuration environment variables
  • TELEDOCK_TOKEN: Telegram token. See https://core.telegram.org/bots
  • TELEDOCK_SUPERADMINS: Comma separated list of Telegram user ids, only users listed here will have access to the bot.

Docker

To simplify the management of the bot there is a Docker image ready to use. You'll only need to mount the docker socket as a volume and set the environment variables (see how). Example:

docker pull mrmarble/teledock # Only needed the first time or to update
docker run -d -v /var/run/docker.sock:/var/run/docker.sock \
--name teledock \
--env TELEDOCK_TOKEN=bot_token \
--env TELEDOCK_SUPERADMINS=tg_userid  \
mrmarble/teledock

TODO

  • Create container
  • Run command inside container
  • Warn the user if tries to stop the bot

Suggestions / Contribution

I made teledock because I need it but if you want to use it and there's something missing or not quite right, feel free to create an issue or a pull request if you know how to fix it yourself

License

This project is licensed under the GPL 3.0 License. See the LICENSE file for details.

Docker Pull Command

docker pull mrmarble/teledock