Table of Contents:
- Intruduction
- Install OS on Raspberry Pi 5
- Connect to Raspberry Pi via
SSH
- Prepare envariement
- Create and Run the Bot
- Keep the bot running in the background using
tmux
- Automatically Start the Bot on Boot (Optional)
Intruduction
In my previous article, I demonstrated how to create and run a Telegram Bot using Python. You can find it here
In this guide, I’ll walk you through hosting your Telegram bot on your own Raspberry Pi server.
Install OS on Raspberry Pi 5
Follow this guide to create an image with Raspberry Pi Imager.
I recommend choosing Raspberry Pi OS Lite
OS because it is the best option in terms of lightweight simplicity.
In the imager settings check the box next to Enable SSH and select use password authentification. This will allow you to connect to your Raspberry Pi via SSH
.
After creating the image on a USB flash drive, insert the flash card into your Raspberry Pi and power it on.
Connect to Raspberry Pi via SSH
- Open the console (cmd or PowerShell on Windows)
- Ping your Raspberry Pi the following command:
ping raspberrypi.local
You’ll receive ping statistics along with the IP address of your Raspberry Pi.
- Use this IP address to connect via SSH:
SSH pi@<your_raspberry_pi_ip> (for example: SSH pi@192.168.0.10)
- Enter the password (default is
raspberry
). I strongly recommend changing this later. - If the password is correct, you will be connected to your Raspberry Pi via
SSH
.
Prepare Envariement
- Update your Raspberry Pi
sudo apt update
sudo apt upgrade
- Install Python
Raspberry Pi OS usually comes with
Python
pre-installed. Check if it's installed:
python3 --version
If Python
is not installed, you can install it using:
sudo apt install python3 python3-pip
- Set Up a Virtual Environment (Optional but Recommended) It’s a good practice to create a virtual environment to keep your project dependencies isolated:
sudo apt install python3-venv
python3 -m venv telegram-bot-env
source telegram-bot-env/bin/activate
- Install the Python Telegram Bot Library
pip install python-telegram-bot --upgrade
Create and Run the Bot
- Create a new
Python
file using thenano
text editor
nano bot.py
- Write your bot code in this new file _(you can use code from my previous article). Press
CTRL + O
then hitEnter
to save changes. To exit pressCTRL + X
. - Run the bot
python3 bot.py
Your bot is now running, and you can test it on Telegram.
However, this method will terminate the bot when you close the terminal.
To keep it running in the background we can use tmux
Keep the Bot Running in the Background Using tmux
Create an Executable Shell Script to Start Your Bot
- Install
tmux
sudo apt update
sudo apt install tmux
- Create a new shell script to start your bot. You can name it start_bot.sh
nano start_bot.sh
- Add the following lines to the script, replacing
bot.py
with the name of your Python bot file andtelegram-bots-env
with your env name:
#!/bin/bash
source telegram-bots-env/bin/activate
python3 bot.py
- Save and exit
(CTRL + O, Enter, CTRL + X)
. - Make the script executable:
chmod +x start_bot.sh
Run Bot via tmux
:
- Start a new
tmux
session:
tmux new -s my_bot_session
- Inside the
tmux
session, run your bot script:
./start_bot.sh
- Detach from the
tmux
session by pressingCTRL + B
, thenD
- Reattach to the
tmux
Session (if needed) To reattach to your bot’stmux
session later, use:
tmux attach -t my_bot_session
Automatically Start the Bot on Boot (Optional)
If you want your bot to start automatically on boot, you can use a systemd service. Here’s how:
- Create a new service file:
sudo nano /etc/systemd/system/my_bot.service
- Add the following configuration, modifying paths as needed:
[Unit]
Description=My Bot Service
[Service]
ExecStart=/usr/bin/tmux new-session -d -s my_bot_session '/path/to/start_bot.sh'
WorkingDirectory=/path/to/my_bot
User=pi
[Install]
WantedBy=multi-user.target
- Save and exit the file.
- Reload the systemd daemon:
sudo systemctl daemon-reload
- Enable the service to start on boot:
sudo systemctl enable my_bot.service
- Start the service:
sudo systemctl start my_bot.service
Top comments (0)
Some comments may only be visible to logged-in visitors. Sign in to view all comments.