Hello, friends. In this post, you will learn how to install UVDesk on Ubuntu 20.04.
UVdesk offers SaaS-based and Open Source helpdesk solution to easier the overall support process to deliver best customer service. All this information can be found on the project’s website.
Install UDVesk on Ubuntu 20.04
1.- Install some required packages
Before starting the whole installation process we have to install some necessary packages.
To do this, open a terminal or start an SSH session on your server and run:
sudo apt update
sudo apt upgrade
Then it installs the necessary packages I referred to. Among them, GIT, Apache, and some modules of the latter.
sudo apt install git unzip apache2 libapache2-mod-fcgid
Then enable the Apache modules needed to perform the installation.
sudo a2enmod actions fcgid alias proxy_fcgi rewrite
And apply the changes by restarting Apache.
sudo systemctl restart apache2
2.- Preparing MariaDB for UVDesk
The next step is to install and configure correctly MariaDB, for this we have a post where it is explained in detail
How To Install MariaDB on Ubuntu 20.04?
After MariaDB is installed and configured, you have to create the database and the user so that UVDesk can work with it.
Open the MariaDB shell:
sudo mysql -u root -p
And then create the database, as well as the user with their permissions.
sudo mysql -u root -p
CREATE YOUR DATABASE uvdeskdb;
GRANT ALL PRIVILEGES ON uvdeskdb . * TO 'uvuser'@'localhost' IDENTIFIED BY 'uvpps';
FLUSH PRIVILEGES;
exit;
So, now we can continue.
3.- Install and configure PHP for UVDesk
Now the next step is to install PHP along with some of its modules:
sudo apt install php-cli php-fpm php-pdo php-json php-common php-mysql php-zip php-gd php-mbstring php-curl php-xml php-bcmath php-imap php-intl php-mailparse php-pear
And it is advisable to make some changes in the configuration of PHP to adapt it to UVDesk.
Open the PHP configuration file
sudo nano /etc/php/7.4/fpm/php.ini
And with the help of the key combination CTRL + W look for the parameter memory_limit and assign another higher value to it.
memory_limit = 256M
You can also change the Timezone of PHP to your location.
Save the changes and close the editor.
4.- Install UVDesk on Ubuntu 20.04
The installation of UVDesk is through Composer, so we have to install it first.
Download it with the curl command:
curl -sS https://getcomposer.org/installer -o composer-setup.php
And then install it with this command:
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer --version=1.10.17
You can check the status of Composer, by running
composer -V
Now it’s time to create the folder where UVDesk will be and assign it as the owner of the current user:
sudo mkdir /var/www/udvesk
sudo chown -R $USER:$USER /var/www/
And now start the installation with Composer from the created folder.
cd /var/www/udvesk
composer clear-cache
composer create-project uvdesk/community-skeleton helpdesk-project
If the whole process has gone well, you will see a screen output similar to this one:
Now you need to create a new Virtualhost for the application:
sudo nano /etc/apache2/sites-enabled/uvdesk.conf
And add the following content
Listen 8080
<VirtualHost *:8080>
ServerName uvdesk.osradar.test
DocumentRoot /var/www/udvesk/helpdesk-project/public
<Directory /var/www/udvesk/helpdesk-project/public>
Options -Indexes +FollowSymLinks +MultiViews
AllowOverride All
Require all granted
</Directory>
<FilesMatch \.php$>
# 2.4.10+ can proxy to unix socket
SetHandler "proxy:unix:/var/run/php/php7.4-fpm.sock|fcgi://localhost"
</FilesMatch>
ErrorLog /var/log/apache2/uvdesk-error.log
CustomLog /var/log/apache2/uvdesk-access.log combined
</VirtualHost>
Replace ServerName with yours. And save the changes.
Then update the permissions and make Apache the new owner of the UVDesk folder.
sudo chown -R www-data:www-data /var/www/udvesk
sudo chmod -R 755 /var/www/udvesk
And to apply all the changes, restart the service.
sudo systemctl restart apache2
5.- Complete the installation using the web interface
So, open your web browser and go to http://your-server:8080 and you will see the welcome screen
The installer will then perform a system check and if you meet all the requirements, you will see the following screen.
Then, it’s time to set up the parameters of the database that we have previously created. Set yours.
After this, it’s time to create the administrator user.
Then you can configure the website. You can leave it as it is or you can modify the values by which you think convenient.
Finally, you will see the screen where you can start the installation.
If everything goes well, you will see the following screen. There you have the links to the Front-end and the Admin Panel.
This is what the frontend looks like
And so the login screen
When you log in you will see the administration screen.
So enjoy it.
Conclusion
The open-source is gaining more and more ground in the business environment where applications such as UVDesk are becoming impractical for many organizations worldwide.
So, enjoy it.
