https://github.com/g1forfun/raspberry-pi5-dashboard
A real-time web-based monitoring dashboard for your Raspberry Pi, built with Flask and Chart.js.
https://github.com/g1forfun/raspberry-pi5-dashboard
raspberry-pi raspberry-pi-5 raspberrypi
Last synced: 4 months ago
JSON representation
A real-time web-based monitoring dashboard for your Raspberry Pi, built with Flask and Chart.js.
- Host: GitHub
- URL: https://github.com/g1forfun/raspberry-pi5-dashboard
- Owner: g1forfun
- License: gpl-3.0
- Created: 2025-02-25T04:08:21.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-02-25T04:30:19.000Z (4 months ago)
- Last Synced: 2025-02-25T05:19:58.901Z (4 months ago)
- Topics: raspberry-pi, raspberry-pi-5, raspberrypi
- Language: HTML
- Homepage:
- Size: 20.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📊 Raspberry Pi System Monitoring Dashboard
A real-time web-based monitoring dashboard for your Raspberry Pi, built with **Flask** and **Chart.js**.
## 🚀 Features
- 📡 **Real-time system monitoring**: View CPU, CPU Speed, RAM, Disk, Uptime and Temperature usage.
- 📈 **Live graphs** with smooth animations and dynamic updates.
- 🎛 **Adjustable update interval**: Control refresh speed using a slider.
- 🌙 **Dark mode support**: Switch between light and dark themes dynamically.
- ⏸ **Start/Pause Monitoring**: Pause or resume system monitoring at any time.
- 🔧 **Runs on boot**: Automatically starts when the Raspberry Pi is powered on.
---
## 📌 Prerequisites
Before running the dashboard, ensure your **Raspberry Pi OS** is set up with the required dependencies.
### 1️⃣ Update System Packages
```sh
sudo apt update && sudo apt upgrade -y
sudo apt install python3 python3-pip -y
```
### 2️⃣ Install Required Python Libraries
```sh
pip install flask flask-cors psutil
```
### 3️⃣ Set Up the Project Directory
```sh
mkdir -p ~/rpi-dashboard/static
cd ~/rpi-dashboard
```
### 4️⃣ Clone the Repository
```sh
git clone https://github.com/g1forfun/rpi-dashboard.git .
```
### 5️⃣ Start the Flask Server
```sh
python3 app.py
```
The dashboard will be accessible at:
```sh
http://:5000
```
To find your Raspberry Pi’s IP address:
```sh
hostname -I
```
---
## 📜 Running the Dashboard on Boot
To ensure the dashboard runs automatically on startup:
### 1️⃣ Create a systemd Service
```sh
sudo nano /etc/systemd/system/rpi-dashboard.service
```
Paste the following configuration:
```ini
[Unit]
Description=Raspberry Pi Dashboard
After=network.target
[Service]
User=
WorkingDirectory=/home//rpi-dashboard
ExecStart=/usr/bin/python3 /home//rpi-dashboard/app.py
Restart=always
[Install]
WantedBy=multi-user.target
```
### 2️⃣ Enable & Start the Service
```sh
sudo systemctl enable rpi-dashboard
sudo systemctl start rpi-dashboard
```
The dashboard will now start automatically whenever the Raspberry Pi boots.
---
## 🎮 Dashboard Controls
- 🎛 **Adjustable Update Interval**: Use the slider to change how often stats refresh.
- ⏸ **Start/Pause Monitoring**: Click the button to pause or resume system updates.
- 🌙 **Dark Mode Toggle**: Switch between light and dark themes instantly.
---
## 🔧 Troubleshooting
### 🚫 Port 5000 Not Accessible?
```sh
sudo ss -tulnp | grep 5000
```
If Flask is not running, restart the service:
```sh
sudo systemctl restart rpi-dashboard
```
### 🛑 Python Module Errors?
Reinstall dependencies:
```sh
pip install --force-reinstall flask flask-cors psutil
```
### 🔄 Restart Flask Manually
If needed, restart the Flask server manually:
```sh
cd ~/rpi-dashboard
python3 app.py
```
---
## 📝 License
This project is licensed under the **GNU GENERAL PUBLIC LICENSE v3.0**.
See the [LICENSE](https://www.gnu.org/licenses/gpl-3.0.en.html) file for more details.