info_tfgrid/collections/system_administrators/advanced/node_status_bot.md

Node Status Bot

Table of Contents

• Introduction
• Prerequisites
• Deploy a Micro VM
  • Network Choice
• Create a Telegram Bot
• Prepare the VM
• Set the Bot
• Start the Bot
• Set Zinit

---

Introduction

We show how to deploy the Telegram Node Status bot on a micro VM running on the ThreeFold Grid.

The Node Status bot provides realtime status updates and alerts on status changes for nodes on the ThreeFold Grid. You can find an instance live on Telegram.

Prerequisites

To run the bot, you need to have a TFChain account activated with a twin. For this, you can simply create an account on the ThreeFold Dashboard.

• A TFChain account
• TFT in your TFChain account
  • Buy TFT
  • Send TFT to TFChain

Deploy a Micro VM

We start by deploying a micro VM on the ThreeFold Dashboard.

• On the Threefold Dashboard, go to the micro virtual machine deployment page
• Deploy a micro VM (Ubuntu 22.04) with the network connection of your choice
  • Minimum vcores: 1vcore
  • Minimum MB of RAM: 2048GB
  • Minimum storage: 25GB
• After deployment, note the VM IP address
• Connect to the VM via SSH

ssh root@VM_IP_Address

Network Choice

Since the bot works via an outbound connection to the Telegram servers, you do not need any public IP for it. It's thus cheaper to use either WireGuard, Planetary Network or Mycelium.

Create a Telegram Bot

We create a Telegram bot using the BotFather.

Simply go to this link and follow the steps (/newbot ...). Make sure to take note of the bot token for the next steps.

Prepare the VM

We prepare the micro VM to run the Node Status bot.

• Update the VM and install redis-server, git, nano, pip and python3-venv

apt update && apt install redis-server && apt install git && apt install nano && apt install pip && apt install python3.10-venv 

Set the Bot

Now that the VM is prepared, you can quickly set the bot.

git clone https://github.com/threefoldfoundation/node-status-bot.git
cd node-status-bot
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
wget https://github.com/threefoldtech/rmb-rs/releases/download/v1.0.7/rmb-peer
chmod u+x rmb-peer

Start the Bot

Once the bot is set, you can start it with the following line.

python3 node-status-bot.py <bot_token> -s "<mnemonic>"

You can now go on Telegram and test the bot!

Set Zinit

We can make sure the bot will start at any VM reboot by setting a zinit process. We set this using a simple script.

• Create a .yaml file in the zinit folder

nano /etc/zinit/node-status-bot.yaml

• The content should be the following

exec: /root/node-status-bot/start.sh

• Create a script to run the bot

nano start.sh

• The script should contain the following

#!/bin/bash

cd /root/node-status-bot
source venv/bin/activate
python3 node-status-bot.py <bot_token> -s "<mnemonic>" &>> /root/node-status-bot-logs

• Set permissions to the script

chmod +x start.sh

• Start the bot with the zinit command

zinit monitor node-status-bot

• Check if the bot is running

zinit status node-status-bot

You can then use the bot on Telegram and the Python program will restart every time the VM starts.