How to Install

Learn how to install the self-hosted help desk software on a compatible web server.

Before installation

Make sure your server is already set up to serve a PHP/Laravel application and that it meets all the requirements.

We assume that your application will be located at /var/www/fullhelp. For easy upgrades and rollbacks, your working copy of the software will be located at /var/www/fullhelp/live, more on this later.

You should configure your application's domain before running the installation, as it is needed to properly set up the routes. If the domain is changed post-installation, you will get a 404 error which can be corrected easily by changing the domain on the .env file.

The domain name you choose is only for you and your agents, not for your customers. Make sure to use a domain name (or subdomain) that don't interfere with any future public domains or subdomains. For example, if you plan to have a knowledge base on help.mydomain.com, do not use help.mydomain.com as your help desk domain, instead, use something like desk.mydomain.com.

Installation

Step 1: Upload the files to your server

Using your preferred tool unzip the ZIP file you downloaded after your purchase. Once unzipped, upload all the files to /var/www/fullhelp/live in your server.

Step 2: Configure your server's webroot

Once the files are on your server, you can now point your server's webroot to /var/www/fullhelp/live/public, this is where the index.php file is located. This protects your application files and structure from spying eyes.

Apache users: make sure to enable rewrite: sudo a2enmod rewrite && sudo service apache2 reload

Step 3: Run the installer

Now that the files are on your server and that the server is pointing to the application's public directory, your application should be accessible publicly by visiting your app's domain. Fill up the installation form and then press the submit button. The software will perform all the installation tasks, and once finished, disable the installer for security purposes and redirect you to the registration page.

What's next

  1. Receiving emails 
  2. Configure an outbound email service provider
  3. Configure the Queues system (required for sending emails)
  4. Configure the built-in web sockets server or Pusher (required for real-time communication)
Your vote was sent, thanks!
Was this article helpful?

Want to talk to a human?

Feel free to contact us if you cannot find what you are looking for in our help center. We will be answering you shortly!

Feel free to contact us if you cannot find what you are looking for in our help center. We will be answering you shortly!

Contact us
Woman messaging on mobile phone