Skip to content

Installation

Paul edited this page Dec 12, 2017 · 14 revisions

System Requirements

The requirements for this project are very low and not at all CPU, Memory or Storage intensive. It can run along side your desktop, in a virtual machine or on a low powered standalone box like a Raspberry Pi Zero.

At it's most basic all it needs is a working Apache installation with PHP installed with the xml and curl extensions

While this project will most likely run with any webserver that works with PHP it has only been tested in environments running Apache

If you don't want to dedicate a whole a box to this project:

  • It is known to work well on the XAMPP Platform. As that is where it was originally developed. It can easily be run on server you may already have running other services.
  • It has also been tested running in a Hyper-V VM

If you wish to run it on a Raspberry Pi we have a walk through for setting up a new system

Installation in Apache

These instructions assume installation on a Raspberry Pi setup as described in our walk through. Other Linux/Debian type operating systems will be similar

Install GIT and Clone the TCPLightingWebInterface Respository

sudo apt install git

Change to your home directory

cd /home/pi

Clone the repository

git clone https://github.com/bren1818/TCPLightingWebInterface.git

You now have a copy of the base website

Change to the public_html of your virtual host if you created one i.e.

cd /var/www/html/lighting.local/public_html

or the default html directory if you didn't

cd /var/www/html/

copy the cloned project to this directory

cp -R /home/pi/TCPLightingWebInterface/* .

Edit config.inc.php as described in the config.inc.php Configuration

vi config.inc.php

if you plan to use the IFTT Integration also copy the .htaccess file

cp -R /home/pi/TCPLightingWebInterface/.htaccess .

Edit config.inc.php and .htaccess files per the install directions for the project

vi config.inc.php

vi .htaccess

For simple config create blank tcp.token & sched.file and make it writeable by the web server

touch tcp.token
chmod 777 tcp.token
touch sched.sched
chmod 777 sched.sched

config.inc.php Customization

Clone this wiki locally