Installation of Opensource Helpdesk – UVdesk on Ubuntu

Updated 29 May 2023

Facebook Linkedin

Open Source Helpdesk – UVdesk 


UVdesk is available as SaaS-Based Helpdesk and Open Source Helpdesk System also to overcome the workload of Service Representative and streamline the overall support process for better customer service.
Check out UVdesk on Symfony Official Website – Symfony

Let’s take a look at a comprehensive guide for the Open Source Helpdesk Installation process on Ubuntu – UVdesk.

Open Source Helpdesk Installation Process on Ubuntu 

Prerequisites to install Open Source Helpdesk on Ubuntu:

Hardware Requirement

  • Processor: 1.60GHz or higher
  • RAM: 3GB or higher

Software Requirement

Video Tutorial

Steps to Install Open Source Helpdesk Ticketing System on Ubuntu:

This is a quick and easy guide for all developers to get you started down to make a powerful helpdesk solution with Symfony and PHP Framework. Now, let’s get started!

Step 1 – 

Install the community-skeleton project via composer using the below-structured command:

Clear Cache:

Create Project:


Download ZIP as per your System’s PHP version.

Check Following Cases:

Before setting up your project check below things and make changes accordingly:

Case 1. A web server might don’t have permission to allow overriding of the Apache config on a per-directory basis. In apache2.conf, Allow Override needs to be set to All for the directory block as mention below:

<Directory /home/users/www>
Options Indexes FollowSymLink
AllowOverride All
Require all granted

Note: Need to run below commands for enabling mod rewrite rule:

Then, restart web server:

Case 2. If your database password contains some special character(such as #$%@) then change your password and make it without special character.

Case 3. Allow read-write permission for below file & folder:

For .env file – chmod 775 -R path of .env file of UVdesk project

For var folder -chmod 775 -R path of var folder of UVdesk project

For config folder – chmod 775 -R path of config folder of UVdesk project

Case 4. And also check max execution time if it is 30 sec then increase it. Check here.

Case 5. locate .env file in your project and make sure APP_ENV=dev when you are doing your setup.

After that, restart your server by.

Lastly, clear your project cache by:

php bin/console c:c

Step 2 – 

Browse your installed helpdesk project for example – http://domain/installed_folder/

Step 3 –  Set Up Helpdesk

Now browse: http://domain/installed_folder/public/

Step 4 – Evaluating System Requirement

Now You will see the “SETUP UVDESK” button, hit on this button. It brings you to Evaluating System Requirement page to check system compatibility likewise in added screenshot:

Note: To enable the IMAP/mail parser you can have a look here: https://webkul.com/blog/how-to-add-an-extension-imap-and-mailparse-on-windows-linux-mac/

Step 5 – Database Configuration

This page will ask you the details of the database which you have created in Step 2.

Step 6 –  Create Super Admin Account

After filling in the database details you will see Proceed button, Tapping the Proceed button brings up the Create Super Admin Account Page.

Step 7 – Website Configuration

On this page, one can change the member panel prefix or admin panel prefix from here.

Step 8 –  Install Now

Step 9 –  Database Migration

Now, the Helpdesk project is ready to be installed and migrated with the database.


Step 10 – The Helpdesk Has Been Installed Successfully.

What’s Next? 

Congratulations!! Now you have installed UVdesk open source helpdesk on your Mac server successfully. The next step after installation, set up a mailbox with UVdesk to send & receive emails from UVdesk.

Check out the link below to set up Mailbox-

How to Setup Mailbox: UVdesk Open Source Helpdesk

Complete Installation Doc – UVdesk Open Source

Open Source Helpdesk Installation on CentOS – UVdesk

Open Source Helpdesk Installation on Windows using Xampp – UVdesk

Open Source Helpdesk Installation on WAMP – UVdesk

Open Source Helpdesk Installation on MAMP – UVdesk

Are you in trouble? Let’s connect directly to UVdesk developers –

UVdesk Forum!              Developer Visit!              Contact Us!                     Live Demo


Category(s) UVdesk
. . .

Leave a Comment

Your email address will not be published. Required fields are marked*


  • Eroll
    How do you change to an actual ip address e.g. ??
    • Vidushi Singh
      First of all please let me know where you want to change the same? As it come at two places 1st – While configuring database and 2nd when we start the inbuilt server of PHP using this command php bin/console server:run
      Looking forward to hearing from you soon so that I can provide you solution accordingly.
  • Nikos
    The command “php bin/console server:run” runs UVdesk and listens only to (localhost).
    How can it listen to
    Otherwise, it is visible only to localhost…
    Also, is there a way to install UVdesk in root document of eg apache (/var/www/html)?
    • Himani Gupta
      The command “php bin/console server:run” runs UVdesk and listens only to (localhost). How can it listen to
      >> You can change the default local IP and run using this command – “php bin/console server:run”
      Is there a way to install UVdesk in root document of eg apache (/var/www/html)?
      >> Yes, you can! Here is the user guide link, we did the same. Do let me know for any further issue we are here to help refer this link to raise your issue.
      Looking forward to hearing from you soon!
      Thanks for reaching us and have a great day ahead!
  • Nikos
    Is there a way to run UVdesk so that people can see it over the network?
    All the guidelines are for local only configuration…
  • Pablo
    Hi, i’m traying to install it on el cpanel shared hosting but when trying to access the public folder i get HTTP ERROR 500. Do you know why this could be?

    Best regards

    • Himani Gupta
      Hello Pablo,
      Greetings for the day!!
      It seems the community project has not map yet properly on your server thus showing a 505 error.
      To rectify it, we have to look into your configuration. Kindly share proper details along with the error screenshot at support@uvdesk.com
      In the meantime you can also take a help of this video tutorial – https://youtu.be/nMnmmzF72oM might it will help you to proceed.
      Kind Respects
      UVdest Team
  • Abhiranjan
    An exception occurred while executing ‘SELECT t0.id AS id_1, t0.code AS code_2, t0.description AS description_3 FROM uv_support_role t0 WHERE t0.code = ? LIMIT 1’ with params [“ROLE_SUPER_ADMIN”]:
    SQLSTATE[42S02]: Base table or view not found: 1146 Table ‘uvdesk.uv_support_role’ doesn’t exist

    Deploying in apache cenots 7 getting above eeror please help

    • Himani Gupta
      Nice day to you!!
      This is because the respective database table has not mapped properly with the community project. Kindly increase the max execution time in php.ini file(for help) then try to restart the server and set up new project with fresh database.
      For more details, check this solution – https://github.com/uvdesk/community-skeleton/issues/290
      Still, you have further doubt or any kind of issue. Feel free to reach out us at support@uvdesk.com
      KInd Respects
      UVdesk Team
  • Valdis
    Hello, I did try to install you opensoruce, but got this erros
    Best Regards
    • Aanchal Chaudhary
      Hello Valdis,
      Greetings of the day!
      To get a quick fix of this issue, please do email us at support@uvdesk.com accordingly the team will assist you.
      Looking forward to hearing from you soon so that I can provide you solution accordingly.
    • Himani Gupta
      Hello Valdis,
      Thanks for considering our community helpdesk solution.
      It may be probably because of two reasons.

      1. .env of your project have no read/write permission please enable it.
      2. max_execution_time in your php.ini file has less execution time please increase time and restart your server.

      Or kindly try to run the below command –
      php bin/console doctrine:migrations:diff
      php bin/console doctrine:migrations:migrate

      Still, you are getting the same issue then email us at support@uvdesk.com

  • css.php