/dockeroller

A cool ChatOps Cli tool for connecting your docker engine to a telegram bot

Primary LanguageGoMIT LicenseMIT

Dockeroller 🐳

Dockeroller (docker controller) is an open-source project giving you the power to control your docker daemon through Telegram, it was made for fun and personal use, but it appears to have many real-world use cases and it is a part of ChatOps world!

Important

Dockeroller is made to run self-hosted, so WE WON'T ACCESS or STORE ANY OF YOUR DATA in any terms.

Caution

Dockeroller is in Alpha phase and not yet production-ready

How to use

First make sure you installed go version 1.19 or above then run:

go install github.com/arshamalh/dockeroller@main

Then you should make a bot (it's name and username doesn't matter) with bot father, copy its token, then you can run the CLI using:

dockeroller start --token "<YOUR-TOKEN>"

And now your docker daemon is accessible thorough your Telegram bot.

Security

There is no security concerns as long as you keep your telegram account safe, and Whitelist known ids:

dockeroller start -w 22,33,44

Dockeroller will return your ChatID when you message it in an UnAuthorized state, then you can whitelist it.

We will also add a password mechanism soon.

Features

  • Containers
    • List
    • Start
    • Stop
    • Live logs
    • Live stats
    • Remove
    • Rename
  • Images
    • List
    • Remove
    • Tagging

Some Screen Shots

dockeroller containers list started one

dockeroller containers list stopped one

dockeroller start command