Faveo Helpdesk Installation on Debian 8

Introduction

This document will list steps to install Faveo Helpdesk on a new Debian server.

We will install following dependencies in order to make Faveo Help Desk work

• NGINX
• PHP 7.1
• PHP Extensions: listed in server requirement
• MariaDB
• Composer
• Cron Job

Read the detailed list of server requirement

We are using vi editor throughout to open and edit file, you can use nano editor also

Configure IPtables

Please note that you have to make changes in the iptables configurations. This allows to open ports that are necessary in Faveo installation.

iptables -A INPUT -p tcp --dport 22 -m conntrack --ctstate NEW,ESTABLISHED -j ACCEPT

iptables -A OUTPUT -p tcp --sport 22 -m conntrack --ctstate ESTABLISHED -j ACCEPT

iptables -A INPUT -p tcp --dport 80 -m conntrack --ctstate NEW,ESTABLISHED -j ACCEPT

iptables -A OUTPUT -p tcp --sport 80 -m conntrack --ctstate ESTABLISHED -j ACCEPT

iptables -A INPUT -p tcp --dport 443 -m conntrack --ctstate NEW,ESTABLISHED -j ACCEPT

iptables -A OUTPUT -p tcp --sport 443 -m conntrack --ctstate ESTABLISHED -j ACCEPT

PS: You have to reset the firewall and iptables to your specifications

Create a user for faveo and Install common packages

useradd -r www-data && usermod -G www-data www-data

apt-get update && apt-get -y upgrade

apt-get install python-software-properties git curl openssl vim -y

apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xcbcb082a1bb943db

wget https://www.dotdeb.org/dotdeb.gpg && apt-key add dotdeb.gpg

Update all the Repos

vi /etc/apt/sources.list

Copy this content to above file

deb [arch=amd64,i386] http://mariadb.biz.net.id/repo/10.2/debian jessie main 

deb-src http://mariadb.biz.net.id/repo/10.2/debian jessie main

deb http://packages.dotdeb.org wheezy all

deb-src http://packages.dotdeb.org wheezy-php56 all

Install MariaDB and create DB

apt-get update

apt-get install mariadb-client mariadb-server -y

mysql_secure_installation

mysql -u root –p

MariaDB [(none)]> CREATE DATABASE faveo;

MariaDB [(none)]> GRANT ALL PRIVILEGES ON faveo.* TO 'faveouser'@'localhost' IDENTIFIED BY 'faveouser_passwd';

MariaDB [(none)]> FLUSH PRIVILEGES;

MariaDB [(none)]> \q

Install Nginx and PHP with extensions

apt-get install nginx php5-fpm php5-cli php5-mcrypt php5-gd php5-mysql php5-imap php5-curl -y

php5enmod mcrypt

wget -O /etc/nginx/sites-available/faveo https://www.faveohelpdesk.com/user-manual/code/debian8/sitesavailable.txt

#Change your_faveo_site with your domain name

vi /etc/nginx/sites-available/faveo

ln -s /etc/nginx/sites-available/faveo /etc/nginx/sites-enabled/faveo

Configure PHP-FPM

wget -O /etc/php5/fpm/pool.d/www-data.conf https://www.faveohelpdesk.com/user-manual/code/debian8/php-fpm.txt

Removing default file

rm /etc/php5/fpm/pool.d/www.conf

Restart PHP FPM service

service php5-fpm restart

Generate SSL Certificate

mkdir -p /etc/nginx/ssl

cd /etc/nginx/ssl

openssl genrsa -des3 -passout pass:x -out faveo.pass.key 2048

openssl rsa -passin pass:x -in faveo.pass.key -out faveo.key

rm faveo.pass.key

openssl req -new -key faveo.key -out faveo.csr

openssl x509 -req -days 365 -in faveo.csr -signkey faveo.key -out faveo.crt

Create a folder for Faveo and clone Faveo Help Desk Community latest release from Github to it

mkdir -p /opt/faveo/log && mkdir -p /opt/faveo/run 

git clone https://github.com/ladybirdweb/faveo-helpdesk.git /opt/faveo/faveo-helpdesk

chown -R www-data:www-data /opt/faveo

chmod -R 755  /opt/faveo

chmod -R 755  /opt/faveo/faveo-helpdesk

chmod -R 755  /opt/faveo/faveo-helpdesk/storage

rm -rf /opt/faveo/faveo-helpdesk/example.env

Install Composer

Change the directory to faveo

cd /opt/faveo/faveo-helpdesk

curl -sS https://getcomposer.org/installer | php

mv composer.phar /usr/local/bin/composer

composer install --no-dev -o

/etc/init.d/nginx restart

Setup Cron

We are using default localhost URL where Faveo is installed, you can change the URL based on your system setting and IP address

crontab -e

* * * * * php /opt/faveo/faveo-helpdesk/artisan schedule:run >> /dev/null 2>&1

Start Installation

Now you can install Faveo via GUI Wizard or CLI.

You can access Faveo url in the browser

PS: You have to reset the firewall and iptables to your specifications