Skip to content

mandulaj/PiDashboard

Repository files navigation

PiDashboard - Have your Pi under control

Monitoring server for Raspberry Pi

What is it?

This project aims at delivering a beautiful interface for monitoring and controlling your Raspberry Pi remotely from anywhere. Want to check the temperature? No problem. Want to have a quick top overview of your Pi? Just open a browser and type the IP of your Raspberry Pi. We will do the rest and provide you with a beautiful and rich experience.

Demo

Try a sort of working demo version of PiDashboard

How to install?

Via npm

    $ sudo npm install -g pi-dashboard
    $
    $ sudo PiDash

From GitHub

    $ git clone https://github.com/zpiman/PiDashboard
    $ cd PiDashboard.js
    $
    $ # download & install all deps
    $ npm install
    $
    $ # download the client plugins
    $ bower install
    $
    $ # compile all the scripts and css
    $ gulp

Getting Help

Type -h or --help to get a small hint about the options.

Choosing port

The default port is 3141 so when the server starts without any parameters you should be able to access it at https://localhost:3141. With -p xxxx the server launches on the specific port. It is recommended to leave this in its default state except you know what you are doing. The port can be customized in the config/config.json file.

Running SSL

By default the server launches as an encrypted https server. If you plan to control your Pi over the internet it is strongly recommended to use SSL. Create a ./keys/server.key and ./keys/server.crt using openssl. We provide a small shell script to do this for you. You can self-sign the certificate but get over with the warnings your browser will give you. You can specify the path for each file in the config.json file.

Set forceSSL in the config.json file to false to run the server in http:// mode. However as I said, this is not a good idea in case you want to work over the internet. The app provides and SSH client which would be an open gate for anyone. Thus I recommend generating a 2048 bit RSA key and getting over with the browser pointing out the self signed certificate. If you want to buy an certificate, go and do so. It will be only for your benefit

Features

  • Easy to install and use
  • SSL enabled
  • Full live system overview
  • CPU, GPU, RAM load & temperature
  • Fun and slick GUI
  • Custom Dashboard page with useful widgets
  • Web SSH client
  • Mobile compatibility
  • Responsiveness
  • Low resource requirements
  • Process overview
  • Useful graphs and time logs

Changelog

v0.0.9
  • Published PiDash on npm
v0.0.7
  • Too many updates to list here :)
v0.0.2
  • Added index.html file with a 3D Raspberry Pi model
  • Base Framework for animating 3D elements
v0.0.1
  • Alpha testing
    • Help menu
    • SSL
    • Port configuration
    • config.json configuration file

TODO

  • update lib/PiDash.js to work with more then one client connection
  • bring myself to work :P

Credits

About

Monitoring server for Raspberry Pi 🍰

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published