Faveo Helpdesk Docker

Deploying Faveo Helpdesk on Docker

drawing

Faveo Helpdesk Docker

A pretty simplified Docker Compose workflow that sets up a network of containers for Faveo Helpdesk.

All the Faveo Helpdesk editions are supported except the community edition.

Usage

To get started, make sure you have Docker and Docker-Compose installed on your system, and then clone the below Git-Hub repository with the below link.

Git-Hub Repo Link

Next, navigate in your terminal to the directory you cloned this, and give the executable permissions to bash scripts.

For all Faveo Editions (except community edition).

chmod +x faveo-run.sh

For Faveo Community Edition.

chmod +x faveo-community-run.sh

Prerequisites To run the script:

  1. A valid domain name fully propagated to your Server’s IP.
  2. Sudo Privilege.
  3. Faveo license and Order number. (this can be obtained from billing https://billing.faveohelpdesk.com). (This is not required for Community Edition)
  4. Unreserved ports 80 and 443. (If it is reserved feel free to edit and change the ports of your choice in docker-copompose.yml)
  5. Operating Systems Centos 7,8 or above and Ubuntu 16,18,20.

Complete the below steps to get the Containers up.

For all Faveo Editons (except community edition).

Run the script “faveo-run.sh” by passing the necessary arguments.

Note- You should have a Valid domain name pointing to your public IP. This domain name is used to obtain SSL certificates from Let’s Encrypt CA, and the mail is used for the same purpose. The license code and Order Number can be obtained from your Faveo Helpdesk Billing portal, and make sure not to include the ‘#’ character in the Order Number.

Usage:

 ./faveo-run.sh -domainname <your domainname> -email <example@email.com> -license <faveo license code> -orderno <faveo order number>

Example: It should look something like this.

 ./faveo-run.sh -domainname berserker.tk -email berserkertest@gmail.com -license 5H876********** -orderno 8123******

For Faveo Community Edition.

Run the script “faveo-communtiy-run.sh” by passing the necessary arguments.

Note- You should have a Valid domain name pointing to your public IP. This domain name is used to obtain SSL certificates from Let’s Encrypt CA, and the mail is used for the same purpose.

Usage:

 ./faveo-community-run.sh -domainname <your domainname> -email <example@email.com>

Example: It should look something like this.

 ./faveo-community-run.sh -domainname berserker.tk -email berserkertest@gmail.com

After the docker installation is completed you will be prompted with Database Credentials please copy and save them somewhere safe and a cronjob will be set to auto-renew SSL certificates from Letsencrypt

Visit https://yourdomainname complete the readiness probe, input the Database Details when prompted, and complete the installation.

There is one final step that needs to be done to complete the installation. You have to edit the .env file which is generated under the Faveo root directory after completing the installation in the browser. Open the terminal and navigate to the faveo-docker directory here you will find the directory “faveo” which is downloaded while running the script this directory contains all the Helpdesk codebase, inside it, you need to edit the “.env” file and add REDIS_HOST=faveo-redis. The “faveo-redis” is the DNS name of the Redis container. Finally, run the below command for changes to take effect.

  docker compose down && docker compose up -d

Updated: