How to Install UVDesk on Linux Mint

UVDesk is an open-source helpdesk and customer support system that allows businesses to manage customer inquiries and support requests effectively. In this tutorial, we will guide you through the process of installing UVDesk on Linux Mint.

Prerequisites

Before you begin, please ensure that you have the following prerequisites.

• A Linux Mint system with root privileges
• Apache2 webserver
• PHP 7.3 or higher
• MySQL database server

Step 1: Download UVDesk

The first step is to download the latest version of UVDesk from the official website. You can use the following command to download the package.

wget https://cdn.uvdesk.com/uvdesk/downloads/uvdesk-community_latest.stable.tar.gz

Step 2: Extract UVDesk Package

Once the download is complete, extract the package using the following command.

tar -zxvf uvdesk-community_latest.stable.tar.gz

Step 3: Move UVDesk Files

Next, move the extracted files to the /var/www/html directory with the following command.

sudo mv uvdesk-community /var/www/html/uvdesk

Step 4: Install Dependencies

UVDesk requires certain PHP extensions to be installed to work correctly. You can install the required PHP extensions using the following command.

sudo apt-get install php7.4-gd php7.4-imap php7.4-intl php7.4-cli php7.4-curl php7.4-mbstring php7.4-json php7.4-xml php7.4-zip php7.4-apcu php7.4-sqlite3 php7.4-mysql php7.4-pgsql

Step 5: Set File Permissions

To ensure proper file permissions and ownership, execute the following commands.

sudo chown -R www-data:www-data /var/www/html/uvdesk
sudo chmod -R 777 /var/www/html/uvdesk

Step 6: Create Database

Next, you need to create a new MySQL database and user for UVDesk. You can use the following commands to create the database and user.

CREATE DATABASE uvdesk;
GRANT ALL PRIVILEGES ON uvdesk.* TO 'uvdeskuser'@'localhost' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

Replace uvdeskuser and password with your desired username and password.

Step 7: Start Installation Wizard

You can now open your web browser and navigate to http://your_domain/uvdesk/en/install to start the UVDesk installation process. Follow the on-screen instructions to complete the installation.

Step 8: Update Apache2 Configuration

Finally, you need to update the Apache2 configuration file to set the document root for your UVDesk installation. Open the Apache2 configuration file with the following command.

sudo nano /etc/apache2/sites-available/000-default.conf

Add the following lines to the configuration file under the VirtualHost block.

DocumentRoot /var/www/html/uvdesk/public
<Directory "/var/www/html/uvdesk/public">
    AllowOverride None
    Require all granted
</Directory>

Save and close the configuration file. Then, restart the Apache2 webserver with the following command.

sudo systemctl restart apache2

Conclusion

Congratulations! You have successfully installed UVDesk on your Linux Mint system. You can now log in to your UVDesk dashboard and start managing customer inquiries and support requests.