Skip to content

Centralized Management for Systems Administration (CMSYS) bot for Telegram

License

Notifications You must be signed in to change notification settings

oddworldng/cmsysbot-telegram

Repository files navigation

CMSysBot banner

Build Coverage Quality Docs License
Build Status Coverage Status Codacy Badge Documentation Status License: GPL v3

Table of contents

Description

Centralized Management for Systems Administration (CMSysBot) it is a Telegram bot that allows you to manage computers in a local network from the bot itself, automating tasks like, for example, executing a series of commands on all computers, or performing updates and collecting information. All in a centralized way.

Also, the bot is easily extensible by adding plugins (bash scripts), so any action that could be performed on a single computer can be easily replicated to the whole local network by using the bot.

Documentation

cmsysbot-telegram's documentation lives at readthedocs.io

Contributing

Contributions to the project are really appreciated! Please, refer to the contribution guide and code of conduct before contributing.

Installing

Dependencies

NOTE: This bot only works with Python 3.6 or greater

Python3 libraries

Installation guide

First of all, you need a server with any GNU/Linux distribution, we have tested this bot on a Debian based operating system.

Once you have installed the server operating system, you have to get the bot from GitHub, install python3 libraries and system dependencies:

Download the bot

git clone https://github.com/oddworldng/cmsysbot-telegram.git

Install Python3 libraries

Go into cloned folder cmsysbot-telegram and execute:

make install

Install system dependencies

sudo apt install -y sshpass

Getting started

Server

How to run

To run this bot in your server, go to your git cloned folder cmsysbot-telegram (by default) and execute this command:

make run

How to configure

First of all, you have to create a new Telegram bot using BotFather bot and get the bot token.

Once you've got it, copy your bot token into config/config.json file, in token filed.

Make sure to fill up all fields in the config/config.json file.

Client

How to run

That's all! Now you can open your Telegram client and start a chat with your new bot @YourTelegramBot to use it.

Social media

Authors

About

Centralized Management for Systems Administration (CMSYS) bot for Telegram

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •