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
Copy after login
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)
Copy after login
- 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
Copy after login
- Install Python
Raspberry Pi OS usually comes with Python pre-installed. Check if it's installed:
python3 --version
Copy after login
If Python is not installed, you can install it using:
sudo apt install python3 python3-pip
Copy after login
- 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
Copy after login
- Install the Python Telegram Bot Library
pip install python-telegram-bot --upgrade
Copy after login
Create and Run the Bot
- Create a new Python file using the nano text editor
nano bot.py
Copy after login
- Write your bot code in this new file _(you can use code from my previous article). Press CTRL + O then hit Enter to save changes. To exit press CTRL + X.
- Run the bot
python3 bot.py
Copy after login
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
Copy after login
- Create a new shell script to start your bot. You can name it start_bot.sh
nano start_bot.sh
Copy after login
- Add the following lines to the script, replacing bot.py with the name of your Python bot file and telegram-bots-env with your env name:
#!/bin/bash
source telegram-bots-env/bin/activate
python3 bot.py
Copy after login
- Save and exit (CTRL + O, Enter, CTRL + X).
- Make the script executable:
chmod +x start_bot.sh
Copy after login
Run Bot via tmux:
- Start a new tmux session:
tmux new -s my_bot_session
Copy after login
- Inside the tmux session, run your bot script:
./start_bot.sh
Copy after login
- Detach from the tmux session by pressing CTRL + B, then D
- Reattach to the tmux Session (if needed)
To reattach to your bot’s tmux session later, use:
tmux attach -t my_bot_session
Copy after login
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
Copy after login
- 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
Copy after login
- Save and exit the file.
- Reload the systemd daemon:
sudo systemctl daemon-reload
Copy after login
- Enable the service to start on boot:
sudo systemctl enable my_bot.service
Copy after login
- Start the service:
sudo systemctl start my_bot.service
Copy after login
The above is the detailed content of Host Telegram Bot on Raspberry Pi 5. For more information, please follow other related articles on the PHP Chinese website!