# Generic
* [Machinery](#machinery)
* [Compile](#machinery-compile)
* [Configure](#machinery-configure)
* [Run](#machinery-run)
* [Web](#web)
* [Install webserver + PHP (optional)](#web-installation-webserver)
* [Install source](#web-installation-source)
* [Auto removal](#auto-removal)
## Machinery
### Compile
Update the packages and kernel.
sudo apt-get update && sudo apt-get upgrade
Install development tools (c++, cmake).
sudo apt-get install git cmake subversion libav-tools dh-autoreconf libcurl4-openssl-dev yasm libx264-dev pkg-config libssl-dev
If you want to use IP cameras, make sure to compile FFMPEG with x264 support.
git clone https://github.com/FFmpeg/FFmpeg ffmpeg
cd ffmpeg && git checkout remotes/origin/release/2.8
./configure --enable-gpl --enable-libx264 --enable-shared --prefix=/usr/local
make && sudo make install
Go to home directory and pull the machinery from github.
cd && git clone https://github.com/kerberos-io/machinery
Compile the machinery; this can take some time.
cd machinery && mkdir build && cd build
cmake .. && make && make check && sudo make install
Start the machinery on start-up.
sudo systemctl enable kerberosio
### Configure
The configuration files can be found at **/etc/opt/kerberosio/config**. By default the Raspberry Pi Camera module is set as capture device. You can update the **config.xml** file to change it to **USBCamera** or **IPCamera**. Images are stored in the **/etc/opt/kerberosio/capture** directory by default; this location can be changed by editing the **io.xml** file.
### Run
After kerberos is installed a binary is available at **/usr/bin/kerberosio**. Just run following command in your terminal to start kerberosio.
kerberosio
## Web
### Install web
If you want to install **the web**, you'll need to have **a webserver** (e.g. Nginx) and **PHP** running with some extensions. You also need **NodeJS** and **npm** installed to install **Bower**. Below you can find the installation procedure to install the web on your preferred environment.
**Install Dependencies**
Install Git, PHP7 (+extensions) and NodeJS.
A) Ubuntu
sudo apt-get update && sudo apt-get upgrade
curl -sL https://deb.nodesource.com/setup | sudo bash -
sudo apt-get install git php7.0-cli php7.0-gd php7.0-mcrypt php7.0-curl php7.0-mbstring php7.0-dom php7.0-zip php7.0-fpm nodejs npm
sudo ln -s /usr/bin/nodejs /usr/bin/node
B) Raspbian
echo "deb http://mirrordirector.raspbian.org/raspbian/ stretch main contrib non-free rpi" | sudo tee --append /etc/apt/sources.list
sudo apt-get update
sudo apt-get install -t stretch php7.0 php7.0-curl php7.0-gd php7.0-fpm php7.0-cli php7.0-opcache php7.0-mbstring php7.0-xml php7.0-zip php7.0-mcrypt nodejs npm
sudo ln -s /usr/bin/nodejs /usr/bin/node
C) OSX
brew install php7.0 php7.0-curl php7.0-gd php7.0-fpm php7.0-cli php7.0-opcache php7.0-mbstring php7.0-xml php7.0-zip php7.0-mcrypt nodejs npm
**Configure webserver**
Install Nginx,
sudo apt-get install nginx
or if you're running OSX use brew.
sudo brew install nginx
Creating a Nginx config.
sudo rm -f /etc/nginx/sites-enabled/default
sudo nano /etc/nginx/sites-enabled/default
Copy and paste following config file; this file tells nginx where the web will be installed and that it requires PHP.
server
{
listen 80 default_server;
listen [::]:80 default_server;
root /var/www/web/public;
server_name kerberos.rpi;
index index.php index.html index.htm;
location /
{
autoindex on;
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$
{
fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
**Clone source**
Create a www location.
mkdir -p /var/www
Get the source code from Github.
cd /var/www && sudo git clone https://github.com/kerberos-io/web && cd web
Install PHP packages by using composer.
curl -sS https://getcomposer.org/installer | sudo php
sudo mv composer.phar /usr/bin/composer
sudo composer install
Add write permission for the storage directory, and the kerberos config file.
sudo chmod -R 777 storage
sudo chmod -R 777 bootstrap/cache
sudo chmod 777 config/kerberos.php
Install bower globally by using npm.
sudo npm -g install bower
Install Front-end dependencies with bower
cd public
sudo bower --allow-root install
Reboot
sudo reboot
## Auto removal
By default images or videos **aren't removed automatically**. This means that Kerberos.io will keep writing to disk, even if there is no more space available on your disk. When your **disk is full** you'll be **experiencing strange errors**: a corrupt web interface, blank images or corrupt videos.
To resolve this your should install a simple **bash script** and initiate **a cronjob** which continuously poll your filesystem, and start removing media when your disk is getting full.
Create a bash script and copy following script.
nano /home/[your user]/autoremoval.sh
Copy following script (make sure the partition is correct, this is the default one for a Raspberry Pi).
partition=/dev/root
imagedir=/etc/opt/kerberosio/capture/
if [[ $(df -h | grep $partition | head -1 | awk -F' ' '{ print $5/1 }' | tr ['%'] ["0"]) -gt 90 ]];
then
echo "Cleaning disk"
find $imagedir -type f | sort | head -n 100 | xargs -r rm -rf;
fi;
Make the script executable.
chmod +x /home/[your user]/autoremoval.sh
Initiate a cronjob, and select the **nano** editor.
crontab -e
Append following line, to execute the **autoremoval.sh** script every 5min.
*/5 * * * * /bin/bash /home/[your user]/autoremoval.sh