Installation of Opensource Helpdesk – UVdesk on Ubuntu

Open Source Helpdesk – UVdesk 

Open Source Help Desk Ticketing


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.

We have realized that every business is not common and their way of approaching with customers is different therefore they need their own customized, flexible and modified helpdesk solution thus we built opensource helpdesk ticket system.

Anyone can inspect, modify or utilize the source code of Symfony component-based ticketing system for any purpose like module building, app integrations, features add-on or to utilize it as their own helpdesk.


Before creating your UVDesk Helpdesk project, make sure that you have already installed all the following Prerequisite –

  • Composer
  • PHP Version: PHP 7 or Higher
  • Web server: Apache, Nginx
  • PHP extensions: PHP IMAP and PHP Mailparse
  • Database required: MySQL
  • Prepared package: WAMP(for windows), XAMPP(for Windows and Mac), MAMP(for Mac)

Installation of UVdesk Opensource Helpdesk

Installation of UVdesk Opensource Helpdesk In this article you will learn how to install UVdesk Opensource helpdesk project on localhost server, This brief Article is going to show new users and developers an easy way to get UVdesk working 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: Setup Webserver

UVdesk requires webserver to serve website on webbrowser and today’s Apache webserver is famous along all users and in use.

So go and install Apache webserver from their official website or for more information you can visit this UserGuide.

Step 2: Create a MySQL Database

UVdesk uses a MySQL database to manage data, like agent and Knowledgebase information. We have MySQL installed and configured, but before procceding further you need to make a database which will be used further while migrating with UVdesk in installation process.

Using a browser, enter the url(localhost/phpMyAdmin): to create a new empty database by using phpMyAdmin. Now, start by logging into the MySQL root account:

UVdesk Ubuntu phpmyadmin

Then write name of database, Here i use “uv_open_source” then hit on Create button.

Step 3: Download UVdesk and Set Up UVdesk Files

Next step, visit UVdesk website and download latest zip file as per supported PHP version.

UVdesk open source helpdesk

Step 4: Upload Package to Webserver

When you are done with download the zip file and after creating a empty database, extract the download file into Apache2 root directory(by default it is – /www/html/ or you can check your document root) to install UVdesk.

Step 5: Setup UVdesk

Now, in this step we’re launching open source helpdesk software, go to your preferred browser and type in the url http://localhost/folder/public or http://website.com/public pointing to your public folder residing under project directory.

UVdesk opensource setup

Step 6: Evaluating System Requirement

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

Now, click on Proceed button, In case your system is not compatible with UVdesk Community Edition you will be not able to proceed further.

Step 7: Database Configuration

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

Step 8: Create Super Admin Account

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

Step 9: Website Configuration

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


Step 10 – Database Migration

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

Now installation has been done, just click on admin panel link which will redirect to administrator panel from where you can manage both your agent and customer as well.

1. Agent Dashboard 


link to login as a agent – http://website.com/public/en/member/login or http://localhost/folder/public/en/member/login

Agent dashboard - UVdesk

To Access Agent Dashboard

By entering super admin credential which you have entered while installation you will be redirected to the UVdesk dashboard.

UVdesk Opensource dashboard

2. Knowledgebase

By clicking Knowledgebase link, will see the support panel where your customer explore some of your most popular and common articles and able to raised a ticket about their doubt.

Contact Us: In case your customer won’t be able to find their answer from knowledgebase page and wanna to contact with your support team then by clicking the contact us button he/she will be able to create a ticket

Sign In: Customer have separate panel that will help to check all updates and history of the tickets.


Further more this is the link for customer login – http://localhost/folder/public/en/customer/login or http://website.com/public/en/customer/login

Knowledgebase UVdesk Open source

You have successfully installed and setup UVdesk Open Source Helpdesk , now the next step will be mailbox configuration to collect all the customer query as a ticket at one place. Follow further steps to setup mailbox by using this user guide – How to Setup Mailbox?

You can also check out the devdocs of UVdesk Opensource Helpdesk on Github. Keep a loyal and friendly relation with your customer by assisting amazing customer support with UVdesk Opensource Helpdesk.

Thank you for viewing this blog, please share your kind views about this Open source Helpdesk Project on Support or support@uvdesk.com

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!
  • 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