Skip to content

A web-based management tool for Raspberry PI / Raspbian.

License

Notifications You must be signed in to change notification settings

MagicCube/rpi-man

Repository files navigation

rpi-man

A web-based management tool for Raspberry PI / Raspbian.

YES, indeed it is powered by Node.js v6 on Raspberry PI 3.

This project is inspired by vaslabs's pi-web-agent which is unfortunately not working for my Raspberry PI (I still don't know why...)

1. Features

  • A web-based management tool for Raspberry PI. You can treat it like the web interface to the routers.
  • Modern user interface.
  • You can easily use it to
    • Monitor CPU & memory usage / CPU temperature
    • Start / stop / restart services
    • Web-based terminal
    • Reboot
  • It also provide RESTful APIs for the further integrations.

2. Reuqirements

2.1 Equipment

  • Raspberry PI 3 Model B with the latest Raspbian OS installed

  • Node.js v6.0

    • By default Node.js v0.x is installed in the Raspbian, you need to uninstall it first if you want to have a try of this project.

      $ sudo apt-get uninstall nodejs
  • One more thing, you need to run it as root user, or at least sudoer.

    • Follow this instruction to install Node.js v6.x on your Raspbian.

3. How to Install

3.1 Clone to your Raspberry PI

cd /opt
sudo git clone https://github.com/MagicCube/rpi-man.git

3.2 Install

$ cd rpi-man
$ sudo ./rpi-man-get install

3.3 Automatically Run at Startup

It's easy to make a node program run automatically as a service at startup. Give me somtime, I'll let you know how, or you can just google it. It's on my TODOLIST already.

3.4 Uninstall

Don't like it any more?

$ sudo ./rpi-man-get uninstall

Then simply remove rpi-man by delete the project folder.

3. How to Upgrade

After a new version comes out, you can simply use the following command to upgrade your rbi-web-man.

$ sudo ./rpi-man-get upgrade

4. How to Run

After installation, rpi-man-server will become a global command. You can execute it anywhere.

Start service

$ sudo rpi-man-server start

Open your browser, and open "http://your-raspberry-pi:3000/".

Stop service

$ sudo rpi-man-server stop

Restart service

$ sudo rpi-man-server stop

About

A web-based management tool for Raspberry PI / Raspbian.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages