Open Raspberry Pi Server Dashboard
PHP JavaScript CSS Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
bower_components Reinit Commit Apr 11, 2016
css Introducing OpenRSD class, small fixes in mobile view Feb 17, 2018
dist
img
js Reinit Commit Apr 11, 2016
less Reinit Commit Apr 11, 2016
pages Add more handles for plugins. Jul 16, 2018
plugins/Example
webproxy
.gitignore
Events.php
LICENSE
PLUGINS.MD Few more functions for plugins. Should be enough to make some basic a… Jul 16, 2018
Plugin.php
README.md Improve package update functionality, extend README with Raspbian Str… Feb 2, 2018
bower.json Reinit Commit Apr 11, 2016
classhelper.php Example plugin and basic documentation Jul 16, 2018
dlnd_profile.php
download.php
index.php
logout.php Fixed codingstyle with PHP-CS-Fixer Feb 7, 2018
openrsd.md How to install Jan 5, 2017
page.php Few more functions for plugins. Should be enough to make some basic a… Jul 16, 2018
test.php Fixed codingstyle with PHP-CS-Fixer Feb 7, 2018

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 shellinabox

    In case you have Raspbian Stretch you could set up lighttpd and php7.0-fpm as the BARE MINIMUM:

    sudo apt-get update && sudo apt-get upgrade -y && sudo apt-get -y install git lighttpd php7.0 php7.0-fpm php7.0-curl php7.0-gd php7.0-intl php7.0-mbstring php7.0-mcrypt php7.0-readline php7.0-xml php7.0-zip php-pear expect geoip-bin shellinabox

  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...
    

    For Stretch with lighttpd and php7.0-fpm you should run the following to raise the max execution timeout to 300 seconds, allow passwordless sudo for www-data user, and switch php on for lighttpd:

    sudo sed -i -e "s/^max_execution_time =.*/max_execution_time = 300/g" /etc/php/7.0/fpm/php.ini
    echo "www-data ALL=(ALL) NOPASSWD: ALL" | sudo tee --append /etc/sudoers.d/010_pi-nopasswd
    sudo lighttpd-enable-mod fastcgi-php
    sudo service php7.0-fpm force-reload
    sudo service lighttpd force-reload
    
  2. Then run: sudo sed -i -e "s/SHELLINABOX_ARGS=.*/SHELLINABOX_ARGS=\"--no-beep -t\"/g" /etc/default/shellinabox
  3. Then run: sudo service apache2 restart or sudo service lighttpd force-reload
  4. Then run: cd /var/www/html
  5. Then run: rm -f index.html *Optional!
  6. Then run: git clone https://github.com/mitchellurgero/openrsd
  7. Once the command finishes running, you can go to the following URL to access the admin panel for your pi: "http://YourPIsIPAddress/openrsd"
  8. 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

Screenshots

Screenshot - Dashboard Screenshot - Services Screenshot - User Accounts