xiakai / Raspcontrol

A PHP Raspberry Pi Control Centre

Home Page:http://www.raspcontrol.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Raspcontrol

Raspcontrol has been drastically improved since the inital release, we now have improved security, standalone deployment and many new awesome features!

Getting Started Guide

Typical Requirements:

Raspcontrol is intended to be used with the PHP 5.4 inbuilt web server.

If your distribution does not support PHP 5.4 then you will need to build it from source or use a HTTP server such as Apache to access Raspcontrol.


How to setup:

Getting the source

.zip Download

You can download this as a .zip from the GitHub Repository via the following link:

https://github.com/Bioshox/Raspcontrol/zipball/master

Git Clone

If you have Git installed you can clone the repo

git clone https://github.com/Bioshox/Raspcontrol.git

Getting it running

Raspcontrol is developed to be deployed with PHP 5.4, although it is possible to deploy it with any other HTTP server too.

Deplyoying with PHP 5.4

Navigate to the location you downloaded Raspcontrol to, from that location we need to give ./start.sh Read/Write/Execute Permissions

sudo chmod 0777 ./start.sh

Now we can deploy the server by running the command from the same location

sudo ./start.sh

You can now access Raspcontrol from localhost directly on your Pi, or the Internal IP from a different computer on your LAN and externally if you're using Port Forwarding. (Raspcontrol binds to the IP 0.0.0.0:80 by default)

This will work with PHP 5.4 ONLY you can check your PHP version by running the command

php -v

With Apache

Running Raspcontrol under Apache is considered insecure and not recomended.

Add www-data on Apache to the SUDOERS file

sudo VISUDO

On the last line add the following

www-data ALL=(ALL) NOPASSWD: ALL

Raspcontrol is not designed for production use, adding www-data to a SUDOERS file is dangerous and is not a permanent solution.

If you're accessing Apaches web avaliable directory on your Raspberry Pi (using startx) you can navigate to localhost/raspcontrol, if you're accessing it from another computer on your Network you will need to navigate to http://your.internal.ip/raspcontrol.

Setting up your account

Once you can see a login screen this is your indication that Raspcontrol is now running at this point you must navigate to

raspcontrol/setup.php 

OR

raspcontrol/app/setup.php (if you're not deploying Raspcontrol standalone)

this will create the initial user to login to the system, you can then log in with the usernamev and password that you chose.

/app after /raspcontrol is required if you're not deploying with PHP

For security ensure you remove setup.php once complete


Thanks!

Please feel free to contribute to this development!

raspcontrol.com

Hosting proudly supplied by Fusion Strike

About

A PHP Raspberry Pi Control Centre

http://www.raspcontrol.com

License:Other