Installation of Opensource Helpdesk – UVdesk on Ubuntu

Nishtha Shukla

29 May 2023

Open Source Helpdesk – UVdesk

UVdesk is available as SaaS-Based Helpdesk and Open Source Helpdesk System also to overcome the workload of Service Representative and streamline the overall support process for better customer service.
Check out UVdesk on Symfony Official Website – Symfony

Let’s take a look at a comprehensive guide for the Open Source Helpdesk Installation process on Ubuntu – UVdesk.

Open Source Helpdesk Installation Process on Ubuntu

Prerequisites to install Open Source Helpdesk on Ubuntu:

Hardware Requirement

Processor: 1.60GHz or higher
RAM: 3GB or higher

Software Requirement

PHP 7.3 or higher, PHP 8
Composer: Composer 2
IMAP
MailParse
Server: Apache
Database: MySQL

Video Tutorial

Steps to Install Open Source Helpdesk Ticketing System on Ubuntu:

This is a quick and easy guide for all developers to get you started down to make a powerful helpdesk solution with Symfony and PHP Framework. Now, let’s get started!

Step 1 –

Install the community-skeleton project via composer using the below-structured command:

Clear Cache:

composer clear-cache

1	composer clear-cache

Create Project:

composer create-project uvdesk/community-skeleton helpdesk-project

1	composer create-project uvdesk/community-skeleton helpdesk-project

Download ZIP as per your System’s PHP version.

Check Following Cases:

Before setting up your project check below things and make changes accordingly:

Case 1. A web server might don’t have permission to allow overriding of the Apache config on a per-directory basis. In apache2.conf, Allow Override needs to be set to All for the directory block as mention below:

<Directory /home/users/www>
Options Indexes FollowSymLink
AllowOverride All
Require all granted

Note: Need to run below commands for enabling mod rewrite rule:

a2enmod rewrite

1

a2enmod rewrite

Then, restart web server:

service apache2 restart

1

service apache2 restart

Case 2. If your database password contains some special character(such as #$%@) then change your password and make it without special character.

Case 3. Allow read-write permission for below file & folder:

For .env file – chmod 775 -R path of .env file of UVdesk project

For var folder -chmod 775 -R path of var folder of UVdesk project

For config folder – chmod 775 -R path of config folder of UVdesk project

Case 4. And also check max execution time if it is 30 sec then increase it. Check here.

Case 5. locate .env file in your project and make sure APP_ENV=dev when you are doing your setup.

After that, restart your server by.

service apache2 restart

1	service apache2 restart

Lastly, clear your project cache by:

php bin/console c:c

Step 2 –

Browse your installed helpdesk project for example – http://domain/installed_folder/

Step 3 – Set Up Helpdesk

Now browse: http://domain/installed_folder/public/

Step 4 – Evaluating System Requirement

Now You will see the “SETUP UVDESK” button, hit on this button. It brings you to Evaluating System Requirement page to check system compatibility likewise in added screenshot:

Note: To enable the IMAP/mail parser you can have a look here: https://webkul.com/blog/how-to-add-an-extension-imap-and-mailparse-on-windows-linux-mac/

Step 5 – Database Configuration

This page will ask you the details of the database which you have created in Step 2.

Step 6 – Create Super Admin Account

After filling in the database details you will see Proceed button, Tapping the Proceed button brings up the Create Super Admin Account Page.

Step 7 – Website Configuration

On this page, one can change the member panel prefix or admin panel prefix from here.

Step 8 – Install Now

Step 9 – Database Migration

Now, the Helpdesk project is ready to be installed and migrated with the database.

Step 10 – The Helpdesk Has Been Installed Successfully.

What’s Next?

Congratulations!! Now you have installed UVdesk open source helpdesk on your Mac server successfully. The next step after installation, set up a mailbox with UVdesk to send & receive emails from UVdesk.

Check out the link below to set up Mailbox-

How to Setup Mailbox: UVdesk Open Source Helpdesk