Skip to content

Latest commit

 

History

History
111 lines (79 loc) · 1.96 KB

README.md

File metadata and controls

111 lines (79 loc) · 1.96 KB
Raw

ServerBot

Telegram Bot to manage a server.

Installation

Get a Telegram bot

First, you will need a telegram bot. Ask this to BotFather by sending him the /newbot command.

Configure it with /setcommands and sent this:

hello - say hello
disk - show hard drives usage
uptime - uptime
memory - show memory and swap usage
wakeonlan - wake machines
shutdown - shutdown server
cmd - run custom commands

Install

Install depandancies:

# Debian/Ubuntu
sudo apt install python3 python3-pip python3-venv

Clone the repo

git clone https://github.com/xgaia/serverbot.git
cd serverbot

Create and source a Python virtual environment

python3 -m venv venv
source venv/bin/activate

Install

python3 setup.py install

Configure

Create a config file with the template and edit it

cp config.ini.template config.ini
vim config.ini # Edit the file

  • [telegram]

    • token: the bot token
    • [telegram:authorized_users]: list of username who are authorized to use the bot. Example: me = xgaiia

  • [server]

    • name: the name of the managed server
    • [server:disks]: disks path to manage. Example: root = /
    • [server:cmd]: list of shell command. Example: ls = ls -l

  • [wakeonlan]: list of machine to wake. Example: warmachine = 00:00:00:00:00:00

Run

serverbot -c /path/to/config.ini

Run as a service

Create a /etc/systemd/system/serverbot.service file like:

[Unit]
Description=Telegram bot to manage a Linux server
After=network.target
[Service]
Type=simple
User=root
WorkingDirectory=/root
ExecStart=/path/to/serverbot -c /path/to/serverbot/config.ini
Restart=on-failure
[Install]
WantedBy=multi-user.target

Control the service

# Control whether bot start on boot
systemctl enable serverbot
systemctl disable serverbot

# Manual start and stop
systemctl start serverbot
systemctl stop serverbot

# Status
systemctl status serverbot