Faveo Helpdesk Installation on Ubuntu 16.04 LTS with Nginx

Introduction

This document will list on how to install Faveo Help Desk on a new Ubuntu 16.04 LTS.

We will install following dependencies in order to make Faveo Helpdesk 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 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 update all the repos

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

wget -O /tmp/nginx-gpg.key http://nginx.org/keys/nginx_signing.key && apt-key add /tmp/nginx-gpg.key

wget -O /etc/apt/sources.list.d/Nginx-stable.list https://support.ladybirdweb.com/uploads/ubuntu16.04/nginx-stable-repo.txt   

wget -O /tmp/ondrej-ppa-gpg.key https://support.ladybirdweb.com/uploads/ubuntu16.04/ppa_ondrej-php-gpg-key.txt && apt-key add /tmp/ondrej-ppa-gpg.key 

wget -O /etc/apt/sources.list.d/ondrej-php-trusty.list https://support.ladybirdweb.com/uploads/ubuntu16.04/ppa_ondrej-php-repo.txt

wget -O /tmp/mariadb-gpg.key https://support.ladybirdweb.com/uploads/ubuntu16.04/mariadb-gpg-key.txt && apt-key add /tmp/mariadb-gpg.key

wget -O /etc/apt/sources.list.d/MariaDB101.list https://support.ladybirdweb.com/uploads/ubuntu16.04/mariadb101-repo.txt

Update your system

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

Install Common Packages and PHP with Extensions

In this step we install following

• PHP
• Required PHP Extension
• MariaDB
• Git
• Curl
• OpenSSL

apt-get install curl software-properties-common git sl mlocate dos2unix bash-completion openssl mariadb-server php7.1-xml php7.1-xsl php7.1-mbstring php7.1-readline php7.1-zip php7.1-mysql php7.1-phpdbg php7.1-interbase php7.1-sybase php7.1 php7.1-sqlite3 php7.1-tidy php7.1-opcache php7.1-pspell php7.1-json php7.1-xmlrpc php7.1-curl php7.1-ldap php7.1-bz2 php7.1-cgi php7.1-imap php7.1-cli php7.1-dba php7.1-dev php7.1-intl php7.1-fpm php7.1-recode php7.1-odbc php7.1-gmp php7.1-common php7.1-pgsql php7.1-bcmath php7.1-snmp php7.1-soap php7.1-mcrypt php7.1-gd php7.1-enchant libapache2-mod-php7.1 libphp7.1-embed -y && updatedb


service php7.1-fpm stop

Install NGINX Web Server and update the config files

Installing Nginx Web Server

apt-get install nginx

service nginx stop

mv /etc/nginx/nginx.conf /etc/nginx/nginx.conf.back

wget -O /etc/nginx/nginx.conf https://support.ladybirdweb.com/uploads/ubuntu16.04/faveo-nginx-conf.txt

wget -O /etc/nginx/conf.d/faveo-helpdesk.conf https://support.ladybirdweb.com/uploads/ubuntu16.04/faveo-helpdesk-conf.txt

Edit the faveo-helpdesk.conf with your domain name

rm -rf /etc/nginx/conf.d/default.conf

wget -O /etc/php/7.1/fpm/pool.d/faveo_php.conf https://support.ladybirdweb.com/uploads/ubuntu16.04/faveo_php-conf.txt

Copy Faveo Help Desk from Github

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 www-data:www-data /opt/faveo -R

Provide permissions to the folder

chmod -R 755  /opt/faveo

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

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

Copy Faveo Help Desk via SSH

In case you want to upload the Faveo files from your local system to your server and not use Github, then follow this step

scp username@source:/location/to/file username@destination:/where/to/put

Start Mysql and create database for Faveo

service mysql start

mysql_secure_installation

In this method provide mysql a strong password

mysql -u root -p

CREATE DATABASE faveo;

GRANT ALL PRIVILEGES ON faveo.* TO 'faveouser'@'localhost' IDENTIFIED BY 'faveouserpass';

FLUSH PRIVILEGES;

quit

Start all services

service php7.1-fpm start

service nginx start

service mysql start

Install Composer

Change the directory to faveo folder

curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

composer install

Setup Cron Job

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

* * * * * /usr/bin/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