Faveo Helpdesk Installation on Debian 8 with Apache

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

• Apache
• PHP 7.1 or higher
• 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 IP Tables

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 Apache and PHP with extensions

apt-get install apache2 libapache2-mod-php5 php5-fpm php5-cli php5-mcrypt php5-gd php5-mysql php5-imap php5-curl -y

a2enmod rewrite

a2enmod proxy_fcgi setenvif

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

mkdir -p /var/www/html/faveo 

git clone https://github.com/ladybirdweb/faveo-helpdesk.git /var/www/html/faveo

chown -R www-data:www-data /var/www

chmod -R 755 /var/www/html/faveo

chmod -R 755 /var/www/html/faveo/storage

chmod -R 755 /var/www/html/faveo/bootstrap/

rm /var/www/html/faveo/example.env

Install Composer

cd /var/www/html/faveo

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

php -r "if (hash_file('SHA384', 'composer-setup.php') === '669656bab3166a                                                                                        7aff8a7506b8cb2d1c292f042046c5a994c43155c0be6190fa0355160742ab2e1c88d40d5be660b4                                                                                        10') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('com                                                                                        poser-setup.php'); } echo PHP_EOL;"

php composer-setup.php --install-dir=/usr/local/bin --filename=composer

php -r "unlink('composer-setup.php');"

Create Virtual Config file for Apache

vi /etc/apache2/sites-available/faveo.conf`

Copy the contents below to above file

<VirtualHost *:80> 

ServerName localhost

ServerAdmin webmaster@localhost

DocumentRoot /var/www/html/faveo/public

<Directory /var/www/html/faveo>

AllowOverride All

</Directory>

ErrorLog ${APACHE_LOG_DIR}/error.log

CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Start All Services

a2ensite faveo.conf

a2dissite 000-default.conf

service apache2 restart

service php5.6-fpm restart

service php-fpm restart

service php5-fpm restart

service mysql 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 /var/www/html/faveo/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