How to Install UVdesk with Apache on Ubuntu Linux

Setting up UVdesk with Apache on Ubuntu Linux allows you to create a powerful, customizable customer support ticketing system tailored to your business needs. This comprehensive guide walks you through each step, from preparing your server to troubleshooting common issues, ensuring you can deploy UVdesk efficiently and confidently. Before starting, ensure your Ubuntu server is up-to-date and has internet access, as you’ll need to install necessary dependencies and download files during the process.

What You’ll Need

Ubuntu Linux server (20.04 LTS or newer recommended)
Root or sudo privileges
Domain name pointed to your server’s IP address
Basic knowledge of Linux command line
Apache web server installed and configured
MySQL/MariaDB installed and running
PHP 7.4 or higher with required extensions (like mbstring, ctype, json, etc.)
Composer installed on your server
SSL certificate (optional but recommended for HTTPS)

Step-by-Step

Update your server: Begin by updating your system packages to ensure compatibility.
```
sudo apt update && sudo apt upgrade -y
```

Install required dependencies: Install PHP extensions, Git, and other necessary packages.

sudo apt install php php-cli php-common php-mbstring php-ctype php-json php-xml php-curl php-zip php-mysql php-bcmath php-zip php-gd php-intl php-bcmath php-ldap php-soap php-redis php-xml php-mbstring git unzip curl -y

Install Composer: Download and install Composer, the PHP dependency manager.

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Create a database for UVdesk: Log into MySQL and set up a new database and user.

sudo mysql -u root -p

CREATE DATABASE uvdesk_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'uvdesk_user'@'localhost' IDENTIFIED BY 'your_secure_password';
GRANT ALL PRIVILEGES ON uvdesk_db.* TO 'uvdesk_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Download UVdesk: Clone the latest UVdesk Community Edition from GitHub.

cd /var/www
sudo git clone https://github.com/uvdesk/community-skeleton uvdesk
cd uvdesk

Install dependencies with Composer: Run Composer to install PHP dependencies.
```
sudo composer install
```

Configure environment variables: Copy the example environment file and edit database credentials.

cp .env.example .env
nano .env

Update the following lines:

DB_HOST=127.0.0.1
DB_DATABASE=uvdesk_db
DB_USERNAME=uvdesk_user
DB_PASSWORD=your_secure_password

Generate application key: Run the following command.
```
php artisan key:generate
```

Set permissions: Ensure web server can access storage and bootstrap cache.

sudo chown -R www-data:www-data /var/www/uvdesk
sudo chmod -R 775 /var/www/uvdesk/storage /var/www/uvdesk/bootstrap/cache

Configure Apache Virtual Host: Create a new config file for your UVdesk site.

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

Add the following configuration, replacing ‘yourdomain.com’ with your actual domain:

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /var/www/uvdesk/public

    <Directory /var/www/uvdesk/public>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/uvdesk_error.log
    CustomLog ${APACHE_LOG_DIR}/uvdesk_access.log combined
</VirtualHost>

Enable the site and rewrite module: Activate your configuration.

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

Configure SSL (optional but recommended): Use Certbot to obtain an SSL certificate.

sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d yourdomain.com

Complete installation via web browser: Visit http://yourdomain.com in your web browser.
Follow the on-screen instructions to finalize the UVdesk setup, including creating an admin account and configuring email settings.

Common Mistakes

Not updating server packages before starting, leading to compatibility issues.
Forgetting to set correct permissions on storage and cache directories, causing runtime errors.
Using incorrect database credentials in the .env file, resulting in connection failures.
Failing to enable Apache rewrite module, which prevents pretty URLs and proper routing.
Not restarting Apache after configuration changes, leaving the site inaccessible.

Tips

Always back up your database and files before major changes or updates.
Use strong, unique passwords for database and admin accounts.
Regularly update UVdesk and server packages for security patches.
Configure HTTPS to secure data transmission.
Monitor server logs for errors and fix issues promptly.

Troubleshooting

If UVdesk does not load or you encounter errors:

Check Apache status and logs: Run sudo systemctl status apache2 and review /var/log/apache2/error.log for clues.
Verify database connection: Test credentials by connecting via MySQL CLI or a database client.
Ensure permissions are correct: Confirm that the web server user (www-data) owns the UVdesk files and directories.
Clear cache: Run php artisan cache:clear and php artisan config:clear.
Check URL rewriting: Confirm that AllowOverride All is enabled in your Apache configuration.
Review SSL configuration: If HTTPS is not working, verify your SSL certificate and configuration.

Following these steps and tips will help you successfully deploy UVdesk on your Ubuntu server with Apache, providing a reliable support ticketing system for your organization.

Frequently Asked Questions

1. Can I install UVdesk without a domain name?

Yes, you can access UVdesk via your server’s IP address, but using a domain name is recommended for professionalism and SSL setup.

2. How do I upgrade UVdesk later?

Pull the latest changes from the GitHub repository, run composer update, and clear caches. Always back up before upgrading.

3. Is HTTPS necessary for UVdesk?

While not mandatory, HTTPS encrypts data and secures your support system. It’s highly recommended to enable SSL.

4. Can I customize the UVdesk appearance?

Yes, UVdesk is open-source, allowing you to modify themes and templates within its directory structure.

5. What are the recommended server specifications?

A minimum of 2GB RAM, a modern CPU, and SSD storage are recommended for smooth operation, especially with multiple users.

How to Install UVdesk with Apache on Ubuntu Linux

How to Install UVdesk with Apache on Ubuntu Linux

What You’ll Need

Step-by-Step

Common Mistakes

Tips

Troubleshooting

Frequently Asked Questions

1. Can I install UVdesk without a domain name?

2. How do I upgrade UVdesk later?

3. Is HTTPS necessary for UVdesk?

4. Can I customize the UVdesk appearance?

5. What are the recommended server specifications?

Related