Installing UVdesk - Short Guide

peopleinside

You can download the package here:
https://www.uvdesk.com/en/opensource/ or
https://cdn.uvdesk.com/uvdesk/downloads/opensource/uvdesk-community-current-stable.zip

Than you will need extract on your server and be sure you have requirement.

You can also install UVdesk using SSH and composer (don’t run composer as root)

UVdesk can be also be installed using composer with the following command in the folder where you want install UVdesk.
composer create-project uvdesk/community-skeleton helpdesk-project
At the end of the update you should need to run php bin/console c:c inside the root UVdesk directory
Than you will also need run on SSH the following two commands:
php bin/console d:s:u –force
php bin/console assets:install

Once done you can point your browser to https://domain.ext/uvdeskfolder/public/ than follow the wizard.

Once installed If you did not customize customer and member path you should be able to reach admin adding the following at your domain URL public/en/member/login

Let’s login and configure email:

Swift Mailer
MailBoxes

In email settings I tried to change the support@localhost but also if the page was saved at the refresh the settings is not saved. For resolve this issue you have to go on the uvdesk root and do the following SSH command:

php bin/console c:c

After this you can come back on your ticket system operator email settings and than refresh the page with email settings ad you will see now your correct email address.

Now need fix some other things:

need set the correct domain in /uvdesk/config/packages/uvdesk.yaml
site_url: hepdesk.website.ext/uvdesk/public

Once edited you need save the file than run in Uvdesk root the following SSH command to clear cache:

php bin/console c:c

For test ticket opening send an email to the support email than run the following SSH command in the uvdesk root (not run as root user but as hosting user):

php bin/console uvdesk:refresh-mailbox emailaddress@domain.ext

If the ticket is not created and you get

 1. Processing uvdesk mailbox configuration.

 2. Opening imap stream...

 3. IMAP stream opened.

 4. Fetching Email collection since 22 March 2021.

 5. Total fetched email -> 1

 6. Starting to convert Emails into Tickets ->
 =============================================
=============================================

Converting email 1 out of 1.

Mailbox refreshed successfully !!!

Check site_url in uvdesk.yaml file.
You site url should be path up-to public folder: helpdesk.domain.ext/uvdesk/public
You will find uvdesk.yaml under config->packages directory in your project.

Be sure to avoid http or https before the domain. If the domain is not recognized ticket by email will be not opened and the email will be flagged as read.

Then try to run refresh command.
Clean cache: php bin/console c:c

Useful links:
https://github.com/uvdesk/community-skeleton/issues/369
https://forums.uvdesk.com/topic/1925/installing-and-setup-uvdesk-for-the-first-time

peopleinside

Configure email

{domain.ext:993/imap/ssl}INBOX

Example no validate cert

{imap.mail.yahoo.com:993/imap/ssl/novalidate-cert}INBOX

peopleinside

How to remove public from URL also how hide index.php from URL.
In the main UVdesk root folder you need have an htaccess file with the following rules

RewriteEngine On
RewriteCond %{REQUEST_URI} !^/public/
RewriteRule ^(.*)$ /public/$1 [L,QSA]

In the public folder you need have an .htaccess file where you may want add

RewriteCond %{THE_REQUEST} ^GET.*index\.php [NC]
RewriteRule (.*?)index\.php/*(.*) /$1$2 [R=301,NE,L]

to hide index.php from URL in some situations.
Also if you want force HTTPS you can add:

RewriteCond %{HTTPS} !=on
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

In the existent .htaccess file you should also have:

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ ./index.php/$1 [QSA,L]
    RewriteCond %{HTTP:Authorization} ^(.*)
    RewriteRule .* - [e=HTTP_AUTHORIZATION:%1]
</IfModule>

peopleinside

Many differents additional apps can be added to the UVdesk, for more info look here:
https://store.webkul.com/UVdesk/UVdesk-Open-Source.html

If you have questions please get in touch with the UVdesk team:

On Forum: https://forums.uvdesk.com/
On Ticket: https://www.uvdesk.com/en/contact/