Open Raspberry Pi Server Dashboard
PHP JavaScript CSS Other
Latest commit 0bd7c06 Feb 2, 2017 @mitchellurgero committed on GitHub Update README and add warnings about security issues
Update README and add warnings about security issues with running apache as sudo user.

README.md

OpenRSD - Stable - State: Usable

What is OpenRSD

OpenRSD or ORSD is a set of PHP scripts, JS, HTML, and BootStrap CSS to create a beautiful, easy to use, responsive Dashboard to manage Raspbian based distros for the RPi2-3.

After months of testing, OpenRSD seems to be stable. Please put issues on GitHub if you find any bugs.

OpenRSD How to install & Use

Installing OpenRSD is pretty simple to do. Just follow the below instructions:

  1. This script is only tested on Raspbian, please make sure you are running a distro based on that, or running Raspbian.
  2. Once Raspbian (Or Raspbian based OS) is installed, run(Note: The following is just the BARE MINIMUM to get OpenRSD to run properly, PiVPN and Samba must be installed separately!):

sudo apt-get update && sudo apt-get install git apache2 php5 libapache2-mod-php5 php5-mcrypt expect geoip-bin

  1. PLEASE KEEP IN MIND THAT ONCE APACHE IS RUNNING AS A USER WITH SUDO RIGHTS, IT SHOULD NOT BE ACCESSIBLE VIA THE INTERNET TO KEEP SECURITY AS BEST AS POSSIBLE. AND ALTHOUGH NOT AS BIG A DEAL AS BEING INTERNET ACCESSIBLE, PLEASE ALSO NOT THAT THIS CAN STILL CAUSE ISSUES ON LAN. (Say as an example an attacker got on your network, they could try and access the Pi.)

    Once that is done, run "sudo nano /etc/apache2/apache2.conf" Edit the User and Group to the user/group pi, it should look like this.

    
    ...Some Config stuff...
    User pi
    Group pi
    ...Some Config stuff...
    
  2. Then run: sudo service apache2 restart
  3. Then run: cd /var/www/html
  4. Then run: rm -f index.html *Optional!
  5. Then run: git clone https://github.com/mitchellurgero/openrsd
  6. Once the command finishes running, you can go to the following URL to access the admin panel for your pi: "http://YourPIsIPAddress/openrsd"
  7. Login with the user pi, and whatever password you have set for that user.

Updating OpenRSD

As long as you have not modified any of the files, updating is pretty simple: Just run git pull in the /var/www/html/openrsd directory. Or through the web interface: Advanced Configuration -> Updates

Please visit URGERO.ORG Installation guide