# HESK® PHP Help Desk Software

Version: 3.4.3 from 8th April 2023 Developed by: Klemen Stirn, Mike Koch Help Desk Software HESK Free PHP Scripts | HESK documentation Step by step install guide Quick install guide Changelog

## HESK STEP BY STEP INSTALL GUIDE

- Install HESK
- Upgrade from old HESK version
- Help & Support

## » Install HESK

Please take 5 minutes to read the installation instructions carefully and thoroughly! Doing so will ensure a proper and easy installation.

Before installing HESK, you will need to obtain your MySQL database information, such as database name, user, and password. You need to get this information from your HOSTING COMPANY; HESK cannot help you find it.

TIP: Want a hassle-free help desk working in minutes? Sign up for HESK Cloud instead.

Installation steps:

1. Connect with FTP to the public folder of your server where the rest of your Web site is.

   TIP: The public folder is usually called "public_html", "www", "site" or "htdocs".

   TIP: Learn how to FTP files by reading this FTP and CHMOD tutorial

2. Create a new folder where you will install HESK. Name it anything you like, for example, "helpdesk" or "support".
   Example: /public_html/helpdesk
   Corresponding URL: https://www.example.com/helpdesk

3. Upload all HESK files to your server. PHP files must be transferred in ASCII mode and images in BINARY mode.

   TIP: Most FTP clients will automatically select the proper transfer mode, so you needn't worry about it.

4. Open hesk/install in your browser, for example (modify to your URL):
   https://www.example.com/helpdesk/install

5. The HESK setup script will run. Click INSTALL HESK and follow instructions through 4 steps:

   - STEP 1: License agreement - read the HESK License agreement and confirm that you agree with the terms.
   - STEP 2: Check setup - the script will test your server to see if all required settings are correct and advise solutions to any problems.
   - STEP 3: Database settings - enter your MySQL database settings, and the setup script will test them.
     You need to get the correct MySQL database information from your hosting company!
   - STEP 4: Setup database tables - everything OK; the script will install MySQL tables.

6. Before closing the installation script, DELETE the "install" directory from your server!

7. Well done, now it's time to set up your help desk! Click the Continue link in the install script or open the admin folder in your browser, for example:
   https://www.example.com/helpdesk/admin/

   TIP: HESK passwords are CaSe SeNSiTiVe ("ABCD" is not the same as "abcd") while usernames are not.

8. Click the Settings link in the top menu to get to the settings page (if not there already)

9. Take some time and get familiar with all the available settings. Most should be self-explanatory; for additional information about each setting, click the [?] link for help about the current setting.

   Don't forget to click the Save changes button at the bottom of the settings page to save your settings!

10. Things to do next

    - Click the "Profile" link to set your name, e-mail, signature, and password.

    - Add new categories (departments) on the "Categories" page. You cannot delete the default category, but you can rename it.

    - To create additional staff accounts, visit the "Team" page. You cannot delete the default user (Administrator), but you can change the username.

    - You can create canned responses on the "Canned" page. These are pre-written replies to common support questions.

    - To access and manage your knowledgebase, click the "Knowledgebase" link.

      The knowledgebase is a collection of answers to frequently asked questions (FAQ) and articles which provide self-help resources to your customers. You can arrange articles into categories and subcategories.

      A comprehensive and well-written knowledgebase can drastically reduce the number of support tickets you receive and save a lot of your time.

11. Customers can submit tickets and browse knowledgebase by visiting the main HESK folder, for example:
    https://www.example.com/helpdesk

12. If you have problems/questions, see the "HELP and Troubleshooting" section further down.

13. Support HESK development by purchasing a license

14. Good luck with using HESK!

## » Upgrading from old versions

Please take 5 minutes to read the installation instructions carefully and thoroughly! Doing so will ensure a proper and easy installation.

Known upgrade issues

- HESK language will be reset to English if new text was added.
- When upgrading from very old versions, you might need to reset your password.

TIP: Perform the upgrade in low-traffic hours when your Web site receives the least amount of visits.

Your existing HESK files are contained in a single directory on your server. You will be replacing most of the contents of this directory with the contents of the folder you downloaded containing the new version of HESK.

Upgrade steps:

1. BACKUP YOUR EXISTING HESK DATABASE AND FILES
   ... or don't blame me if something goes wrong.

   TIP: Most hosting companies allow you to backup files and databases from the web hosting control panel. Contact your host if not sure how to do that.

2. Upload and place all of the new HESK files you downloaded into your existing HESK directory on your server EXCEPT these (do NOT upload these files):
   - hesk_settings.inc.php
   - head.txt
   - header.txt
   - footer.txt

   Your HESK directory now contains the updated files you require for updating your copy of HESK.

   TIP: You must transfer images in BINARY and all other files in ASCII mode. Most FTP clients will automatically select the proper transfer mode, so you needn't worry about it.

   Did you rename your HESK's /admin folder? If yes, don't forget to move files from the new version's /admin folder into your renamed folder.

3. Open hesk/install in your browser, for example:
   https://www.example.com/helpdesk/install

4. HESK setup script will show up on the install URL. Click UPDATE HESK and follow instructions. The update consists of 4 steps:

   - STEP 1: License agreement - read the HESK License agreement and confirm that you agree with the terms.
   - STEP 2: Check setup - the script will test your server to see if all required settings are correct and advise solutions to any problems.
   - STEP 3: Database settings - check your MySQL database settings, and the script will test them.
     The settings must be the same as with your old HESK installation
   - STEP 4: Update database tables - everything OK; the script will update existing MySQL tables.

5. Before closing the upgrade script, DELETE the "install" directory on your server!

6. Open the admin panel (https://www.example.com/helpdesk/admin) and log in with your username. If your password doesn't work anymore, reset it.

7. Test HESK to make sure the upgrade was successful and everything works. You may need to modify your Help Desk title and Custom field settings if they are not displaying correctly.

8. If you own a HESK license, you might need to download a new one.

   If not, consider supporting HESK by purchasing a license.

9. Good luck with using HESK!

## » HELP and Troubleshooting

For comprehensive and up-to-date help and troubleshooting guides, please visit:
HESK Knowledgebase

## » Translate HESK to your language

Thanks to our users, who help translate HESK free of charge, multiple languages are available for HESK:

HESK language packs

## » More FREE PHP Scripts

Get more FREE PHP scripts here: PHP Scripts.

© Copyright HESK.COM 2005-2023. All rights reserved.
® HESK is a registered trademark of Klemen Stirn.