How to Install UVDesk on Debian Latest

UVDesk is an open-source helpdesk software designed to facilitate customer support, collaboration, and communication. It is built with PHP and Symfony framework and offers plenty of powerful features such as email integration, intuitive dashboard, multi-language support, and more.

In this tutorial, we will show you how to install UVDesk on Debian Latest edition.

Prerequisites

A server with the Debian operating system.
A non-root user with sudo privileges.

Step 1: Install LAMP stack

Before installing UVDesk, you need to have a web server, PHP, and a database installed on your system. A complete LAMP (Linux, Apache, MySQL, and PHP) stack is recommended.

To install LAMP, run the following commands in the terminal:

sudo apt update
sudo apt install apache2 mysql-server php php-cli php-mysql libapache2-mod-php php-curl php-json php-intl php-mbstring php-xml php-zip

The above command will update your system packages and install Apache, MySQL, and PHP with required modules.

Step 2: Install Composer

Composer is a dependency manager for PHP. We need it to download and install UVDesk along with its dependencies.

To install Composer, run the following commands:

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

This will download the Composer installation script, configure the installation, and install Composer globally on your system.

Step 3: Create a new database

Now, create a new MySQL database and user for UVDesk.

To create a new database, run the following commands:

sudo mysql -u root -p

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

Make sure to replace your_password with a strong password. This will create a new database, a user with corresponding password, and grant all privileges to the user on the database.

Step 4: Download and Install UVDesk

Now, download and install UVDesk on your Debian system by following the below steps:

Create a new directory for UVDesk in your web server document root:
```
sudo mkdir /var/www/uvdesk
```
Change the directory to the newly created folder:
```
cd /var/www/uvdesk
```
Download the UVDesk source code using Composer:
```
sudo composer create-project uvdesk/community-skeleton helpdesk-project
```
This will download the latest version of UVDesk and install it within the helpdesk-project directory.

Configure Apache virtual host for UVDesk:

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

Add the following configuration to the file:

<VirtualHost *:80>
    ServerAdmin [email protected]
    DocumentRoot /var/www/uvdesk/helpdesk-project/public

    <Directory /var/www/uvdesk/helpdesk-project/public>
        AllowOverride All
        Order Allow,Deny
        Allow from All
        Require all granted
    </Directory>

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

</VirtualHost>

Enable the Apache virtual host and necessary modules:

sudo a2ensite uvdesk.conf
sudo a2enmod rewrite headers

Restart Apache web server:
```
sudo systemctl restart apache2
```

Step 5: Setup UVDesk

Finally, open your web browser and navigate to http://your_server_ip/ or http://your_domain_name/. You should see the UVDesk installer page.

Follow the on-screen instructions to set up your UVDesk instance, including the database details, site URL, language, email templates, etc.

Once the installer completes, you'll be redirected to the UVDesk login page. Log in with the administrator credentials and start using UVDesk to manage and resolve your customer support requests.

That's it! You have successfully installed UVDesk on your Debian Latest system.