8. Install on Virtual Hosting

8.1. Requirements

You can install DeskPRO on many third-party web hosting providers.

Some shared web hosting services have limitations which are incompatible with DeskPRO:

  1. You must have access to the CLI version of PHP, not just the CGI/FCGI version. If your webhost hasn’t installed the CLI binary, you will see DeskPRO errors saying “This script must only be run from the CLI.” You can confirm what version is running by connecting with SSH and running:

    /usr/bin/php -v

    You should get a result like ‘PHP 7.0.7 (cli)’. If it says ‘php-cgi’, you will need to request access the CLI binary.

  2. PHP 7.0 is required and you need to be able to enable all the PHP modules required by DeskPRO. See Requirements.

  3. You need to be able to specify the path to DeskPRO’s web root. Some providers may only allow you to upload files to a specific folder (e.g. called ‘public’). DeskPRO requires you to upload the app files and then configure the server to serve files from the www/ directory.

  4. DeskPRO has a command-line based installer and many command-line tools. You need to have access to the command-line (e.g. SSH).

  5. Some web hosting providers limit the frequency of scheduled tasks. You should be able to set a cron job or Windows Scheduled Task to run once per minute.

8.2. Installation

The exact steps to install DeskPRO will vary by hosting provider.

The general steps are:

  1. Download the most recent version of Download from https://www.deskpro.com/downloads/deskpro.zip.
  2. Create a MySQL ‘deskpro’ user account.
  3. Upload DeskPRO to your server and extract.
  4. Configure your server to serve from the DeskPRO www/ sub-directory. For example, if you uploaded DeskPRO to /home/example/deskpro then you need to configure the web root to be /home/example/deskpro/www
  1. From the command-line, begin the installer: php /home/example/deskpro/bin/install
  2. Once installation is complete, you can log on to DeskPRO with the account details you gave during installation. Start by going to the admin interface at /admin/.

After installing DeskPRO, we strongly recommend that you set up Elasticsearch in Server > Elasticsearch to enable greatly improved search capabilities for agents and users.

If your hosting provider doesn’t offer Elasticsearch, you can use a hosted service such as Found.

See the article Using hosted Elasticsearch from Found on our Knowledgebase for details.