/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

Note for developers and contributors

We cache containers and images list, and update this cache after "next, back, list, final rename, final remove" but we don't update this cache after "remove form buttons clicking", because we don't want you to face another container after clicking to "Force: false" button.

Some Screen Shots

dockeroller containers list started one

dockeroller containers list stopped one

dockeroller start command