Stars: 200
Forks: 19
Pull Requests: 7
Issues: 26
Watchers: 5
Last Updated: 2023-09-14 09:49:49
Web-based dashboard interface to check Raspberry Pi hardware and software status with no extra deependencies required.
License: GNU General Public License v3.0
Languages: CSS, JavaScript, PHP
Written in plain HTML5, CSS3, JavaScript and PHP (backend). No extra software required!
Report a bug | Request a new feature | Help develop this project
Loved the project? Please consider giving a star :)
Update your existing dashboard setup by navigating to project root folder and running
git pull
in the terminal. Please keep in mind, this only works if there are no changes in the workspace.
Mobile Light Theme | Mobile Dark Theme |
---|---|
/var/www/html
The following configuration is the commonly recommended set-up for your web server folder and is meant to be secure to a certain level (with the minimum need of permissions):
First, make sure www-data
group exists and add your current user to that system group:
(if you are using another distro than Raspberry Pi OS the username of web server can differ)
sudo groupadd www-data
sudo usermod -a -G www-data www-data
sudo usermod -a -G www-data <yourlogin>
(replace <yourlogin>
with your username)
Second, give the ownership of web folder to the www-data
group and your user.
The following commands ensure that you have full access on the files within the web folder while group members (www-data
) cannot edit/write for security reasons:
sudo chown -R <yourlogin>:www-data /var/www/html
(replace <yourlogin>
with your username)
sudo chmod -R 755 /var/www/html
Reboot your RPi (for permission changes to take effect)
cd /var/www/html
git clone https://github.com/femto-code/Rasberry-Pi-Dashboard.git <your_subfolder_name>
<your_subfolder_name>
with a name of your choice accordingly, you can also rename the base folder at any time afterwards)sudo chown -R <yourlogin>:www-data /var/www/html/<your_subfolder_name>
<yourlogin>
with your username)sudo chmod -R 775 /var/www/html/<your_subfolder_name>
www-data
user exclusively to write/edit (775) files only in your dashboard folder!An erroneous permission typically results in the situation where the user responsible for web server (e.g.
www-data
) does not have rights to create/modify the local config file for saving your dashboard adjustments (your custom thresholds, password etc.). In this case, the dashboard won't work at all and will throw this error.
http://IP_OF_YOUR_RPI/<your_subfolder_name>
sudo usermod -aG video www-data
If you do not use Raspberry Pi OS, but e.g. Ubuntu, you do have to install
libraspberrypi-bin
by runningsudo apt install libraspberrypi-bin
.
The vcgencmd
command (specifically dedicated to RPi firmware) is a system command that requires certain hardware rights. Therefore one has to grant this particular right (to read hardware info) to e.g. www-data
(under which web server is running). This is achieved by adding this user to a designated system group called video, which the standard user pi is part of by default.
Recommended only, if your RPi is not accessible over the Internet!
In order to use the remote shutdown functionality you have to give the user www-data
advanced rights for running one specific command:
sudo visudo
to open the editor for adjusting user rightswww-data ALL=NOPASSWD: /sbin/shutdown
www-data
cannot change settings for you - see issue #22 or read here for help and instructions to solve)local.config
(dynamically created at first start) and apply your custom passphrase string (generated in step 1) as follows (don't alter other lines):[...]
'general' =>
array (
[...]
'pass' => 'YOUR_MD5_PASSPHRASE_HERE',
[...]
),
[...]
As always: Make sure to change the default password (which is root) and choose a more secure one at first setup and if your dashboard is accessible on the network.
Raspberry Pi and the Raspberry Pi Logo are registred trademarks of the Raspberry Pi Foundation