How to Install UVdesk on Ubuntu 18.04 | 20.04

In this article, we are going to shows that how to Install UVdesk on Ubuntu 18.04 | 20.04.

UVdesk is an open-source and cloud-based helpdesk ticketing software that is provides a complete support solutions for any kind of business process to deliver best customer service.

For more details about UVdesk, go to its official website.

Ubuntu is a Linux Operating System based on Debian and mostly composed of non-profit(free) and open-source software. It is a complete Linux operating system that compatible with desktops, laptops, server and other devices. Ubuntu is Open Source so it is freely available for both community and professional support.

if you are a learner and looking for a Linux distribution for Learning then Ubuntu Linux Operating System is best for you as a beginning.

Install UVdesk on Ubuntu

Simply follow below steps to installing UVdesk on your Ubuntu:

Step 1 : Install Apache

Run the commands below to install Apache2 HTTP on Ubuntu server:

sudo apt update
sudo apt install apache2

Run the commands below to stop, start and enable Apache2 service:

sudo systemctl stop apache2.service
sudo systemctl start apache2.service
sudo systemctl enable apache2.service

Step 2 : Install and Prepare MariaDB for UVDesk

To install MariaDB database, simply run the commands below:

sudo apt update
sudo apt install mariadb-server mariadb-client

Run the commands below to stop, start and enable MariaDB service:

sudo systemctl stop mariadb.service
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service

Now, run the commands below to secure MariaDB server by creating a root password and disallowing remote root access.

sudo mysql_secure_installation

When you run the above command, it will prompted to answer the questions as below:

Enter current password for root (enter for none): Just press the Enter
Set root password? [Y/n]: Y
New password: Enter password
Re-enter new password: Repeat password
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]:  Y
Reload privilege tables now? [Y/n]:  Y

Now, Restart the MariaDB server using below command:

sudo systemctl restart mariadb.service

Step 3 : Create UVdesk database

To logon to MariaDB database server, simply run the commands below:

sudo mysql -u root -p

The above command prompted for a password, type the root password that you created in above steps.

Now create a database named uvdesk by using below command:

CREATE DATABASE uvdesk;

Run the command below to create a database user named uvdeskadmin with new password:

CREATE USER 'uvdeskadmin'@'localhost' IDENTIFIED BY 'new_password_here';

Now, Grant the newly created user for full access to the database.

GRANT ALL ON uvdesk.* TO 'uvdeskadmin'@'localhost' WITH GRANT OPTION;

Save your changes and exit:

FLUSH PRIVILEGES;
EXIT;

Step 4 : Install and configure PHP for UVDesk

PHP 7.4 may not includes in Ubuntu default repositories so you will need to get it from third-party repositories. To do that, run the command below:

sudo apt-get install software-properties-common
sudo add-apt-repository ppa:ondrej/php

Now update and upgrade to PHP 7.4 by using command below:

sudo apt update

Run the commands below to install PHP 7.4 and its related modules:

sudo apt install php7.4 libapache2-mod-php7.4 php7.4-common php7.4-gmp php7.4-curl php7.4-intl php7.4-mbstring php7.4-xmlrpc php7.4-mysql php7.4-gd php7.4-xml php7.4-imap php7.4-mailparse php7.4-cli php7.4-zip

After finished installing of PHP 7.4 and its related modules, run the command below to open PHP default config file for Apache2 server:

sudo nano /etc/php/7.4/apache2/php.ini

Open the PHP default configuration file, make the changes on the configuration file as show in below:

file_uploads = On
allow_url_fopen = On
short_open_tag = On
memory_limit = 512M
upload_max_filesize = 100M
max_execution_time = 360
max_input_vars = 1500
date.timezone = America/Chicago

After the changes, save the file and close it.

Next, restart Apache service:

sudo systemctl restart apache2.service

Step 5: Install UVdesk

Before install UVdesk, you will need to Install Composer, Curl and other dependencies:

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

Now change into the Apache2 root directory and downloads UVdesk packages from GitHub by running commands below:

sudo mkdir /var/www/uvdesk
sudo chown $USER:$USER /var/www/uvdesk
cd /var/www/uvdesk
composer clear-cache
composer create-project uvdesk/community-skeleton helpdesk-project

The above command display a success message similar as below:

To start things off, here are a few commands to help you setup:

  * Configuring your project:

    php bin/console uvdesk:configure-helpdesk

  * Run your project through a local php web server:

    php bin/console server:run


Made with 💖  by the UVDesk Team. Happy helping :)

To set the correct permissions for UVdesk, run the commands below:

sudo chown -R www-data:www-data /var/www/uvdesk/
sudo chmod -R 755 /var/www/uvdesk/

Step 6 : Configure Apache2

Run the commands below to create a new configuration file named uvdesk.conf using below command:

sudo nano /etc/apache2/sites-available/uvdesk.conf

After create configuration file, copy and paste the below content into the configuration file and save it. Replace the highlighted line with your own domain name and directory root location:

<VirtualHost *:8080>
     ServerAdmin admin@example.com
     DocumentRoot /var/www/uvdesk/helpdesk-project/public
     ServerName example.com
     ServerAlias www.example.com

     <Directory /var/www/uvdesk/helpdesk-project/public/>
        Options +FollowSymlinks
        AllowOverride All
        Require all granted
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Save the configuration file and exit.

Step 7 : Enable the UVdesk

To enable the UVdesk, run the below command:

sudo a2ensite uvdesk.conf
sudo a2enmod rewrite
sudo systemctl restart apache2.service

Now open your favorite web browser and browse to the server domain name. It will open the UVdesk setup wizard with the welcome screen. Please follow the wizard and Click on LET’S BEGIN button as shown in below:

On the next screen, the setup wizard will check that your system meet the all minimum requirements to run the UVdesk application. If all is good then click on Proceed button.

Next, you will need to add the parameters(username, password and database name) of the database that we created in above steps.

Now, it’s time to create UVdesk super admin account. After fill the details, click on the Proceed button to continue

On the next screen, you will need to configure the website. You can leave it as it is or you can change the values according your choice and click on Proceed button to continue.

Next, a new screen will open with INSTALL NOW button. Click on the install now button to start the installation.

That’s all

If you face any error and issue in above steps , please use comment box below to report.