Skip to content

This tutorial covers the prerequisites and step-by-step installation process for the open-source help desk ticketing system, osTicket.

Notifications You must be signed in to change notification settings

samaankw/osticket-prereqs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 

Repository files navigation

osticket-prereqs

osTicket logo

osTicket - Prerequisites and Installation

This tutorial outlines the prerequisites and installation of the open-source help desk ticketing system osTicket.

Video Demonstration

Environments and Technologies Used

  • Microsoft Azure (Virtual Machines/Compute)
  • Remote Desktop
  • Internet Information Services (IIS)

Operating Systems Used

  • Windows 10 (21H2)

Installation Steps

Step: 1 Connect to Your Machine with Remote Desktop

If you need help connecting to your virutal machine please watch my tutorial

Step 2: Install and Enable Internet Information Services (IIS) in Window

Disk Sanitization Steps

Open the Start menu and search for Control Panel. Once in the Control Panel, click on Uninstall a Program under the "Programs" section. Then, on the left-hand side, select Turn Windows features on or off. In the list that appears, locate and check the box for Internet Information Services (IIS) to enable it, then click OK to apply the changes.


Step 3: Download, Install, and Open the Web Platform Installer

Installing osTicket via Web Platform Installer

Go to the osTicket Installation Files page and click on Download Web Platform Installer. If you're prompted with a warning or confirmation, select Download Anyway to proceed.

Once the download is complete, click Open File from the top-right corner of your browser to begin the installation. Follow the on-screen prompts to complete the setup of the Web Platform Installer.

After the installation finishes, go ahead and launch the Web Platform Installer to begin setting up the components needed for osTicket.

Disk Sanitization Steps

Once the Web Platform Installer is open, go to the top-right corner and search for MySQL 5.5. Locate MySQL Windows 5.5 in the results and click Add. Next, search for PHP in the same search bar, then adjust the list to sort by name. Add all the simple x86 versions of PHP up to version 7.3 from the sorted list. After selecting all the required components, click Install at the bottom of the screen. During installation, you’ll be prompted to create a username and password to complete the setup.


Disk Sanitization Steps

Disk Sanitization Steps

When prompted during the installation, set the username as root and the password as Password1, then follow the on-screen instructions to complete the process. If you receive a message saying that “some products have failed to install,” you can safely ignore it—just click Finish to proceed. Next, download and install the following required components from the provided lab files: PHP version 7.3.8, PHP Manager 1.5.0 for IIS 10, and the Microsoft Visual C++ 2009 Redistributable Package. These installations are essential for ensuring that osTicket runs smoothly on your system.

Disk Sanitization Steps

Disk Sanitization Steps

Step 4: Install osTicket v1.15.8

To begin the installation process, first download the osTicket file provided in the lab files. Once the download is complete, right-click on the file and select "Extract All" to unzip its contents. After extraction, open the newly created osTicket folder. Inside, you'll find a folder named "Upload". Copy this Upload folder and paste it into the following directory: C:\inetpub\wwwroot. Once the folder is in place, rename "Upload" to "osTicket" to keep things organized and to ensure proper configuration during setup

Disk Sanitization Steps

Disk Sanitization Steps

Step 5: Restart the IIS Server

Next, search for Internet Information Services (IIS) in the Start menu and select Open to launch the IIS Manager. Once it's open, click Restart on the right-hand side to ensure the web server is refreshed and ready to serve your files.

In the left-hand panel, navigate through the directory tree by selecting your computer name (e.g., VirtualMachine) > Sites > Default Web Site, and then click on the osTicket folder you previously placed in the wwwroot directory.

With osTicket selected, look to the right-hand panel and click “Browse *:80”. This will launch your default web browser and open the osTicket setup page, confirming that your installation is being served correctly.

Before moving forward with the setup, return to IIS Manager to continue with the necessary configuration steps.

Disk Sanitization Steps

Disk Sanitization Steps

Step 6: Enable Extensions in IIS

Return to IIS Manager and navigate to Sites > Default Web Site > osTicket. Once there, double-click on PHP Manager in the main window. Scroll down to the bottom of the screen and click on "Enable or Disable an Extension" under the PHP Extensions section.

In the list that appears, locate the following extensions:

  • php_imap.dll (this may already be enabled)
  • php_intl.dll,
  • php_opcache.dll. Right-click on each one and select Enable to ensure they're active. These extensions are essential for osTicket to function properly, especially for features like email piping and internationalization.

Disk Sanitization Steps

Disk Sanitization Steps

Step 7: Refresh the osTicket Site in Your Browser

After enabling the necessary PHP extensions, return to your web browser and refresh the osTicket site. You should now see that the Intl Extension has a green checkmark next to it on the requirements page. This indicates that the extension is properly enabled and that your environment is correctly configured to proceed with the installation.

Disk Sanitization Steps

Step 8: Rename

Open File Explorer and navigate to the following path: C: > inetpub > wwwroot > osTicket > include.

Inside the include folder, locate the file named ost-SAMPLEconfig.php. Right-click on this file and rename it to ost-config.php. This step is essential, as osTicket requires this configuration file to complete the installation process and connect to the database properly./p>

Disk Sanitization Steps

Step 9: Assign Permissions to ost-config.php

Right-click on the ost-config.php file and select Properties. In the Properties window, go to the Security tab and click on the Advanced button. Under the Permissions section, click Disable Inheritance, then choose “Remove all inherited permissions from this object.”

This step helps secure the configuration file by ensuring only explicitly defined permissions apply, reducing the risk of unauthorized access or modifications.

Disk Sanitization Steps

Next, click on Add, then select Select a principal. In the dialog box that appears, type "Everyone" and click Check Names to verify the entry. Once confirmed, click OK.

In the permissions window, check Full control to grant all permissions to "Everyone." After selecting all the boxes, click Apply, then OK to save the changes. This temporary permission setting allows osTicket to write to the configuration file during installation. You can tighten these permissions after the setup is complete to enhance security.

Step 10: Continue Settting Up osTicket in Browser

Return to your web browser and click Continue to proceed with the osTicket setup. On the configuration page, fill out the required fields as follows:

Name: Enter a name for your helpdesk (e.g., Helpdesk).

Email: Use any valid email address you'd like to associate with the helpdesk.

First Name: Enter your own first name.

Last Name: Enter your own last name.

Email Address: Provide a valid personal email address—this should be different from the helpdesk's default email.

Username: Use user_admin as the administrator username.

Password: Set the password to Password1.

This information sets up your helpdesk identity and creates the main admin account for accessing the osTicket dashboard.

Disk Sanitization Steps

Step 11: Download and Install HeidiSQL

Next, go to the osTicket Installation Files link provided in your lab and download HeidiSQL, a tool used to manage MySQL databases. Once the download is complete, install and launch HeidiSQL.

In the HeidiSQL interface, click "New" at the bottom-left corner to create a new session. For the connection settings, enter the following:

User: root

Password: Password

After entering the credentials, click Open to connect to the MySQL server.

Once connected, look to the left panel, right-click on Unnamed (or the server name), and select Create New > Database. When prompted, name the new database osTicket and click OK to create it. This will serve as the database for your osTicket installation.

Disk Sanitization Steps

Disk Sanitization Steps

Step 12: Continue Setting Up osTicket

Return to your web browser to complete the osTicket installation form. For the MySQL Database, enter osTicket—this is the database you created earlier in HeidiSQL.

For the MySQL Username, type root, and for the MySQL Password, enter Password1 (make sure it matches what you configured earlier).

Once all the required fields are filled out, click Install Now to begin the final installation process.

Disk Sanitization Steps

Congratulations! You have sucessfully installed osTicket adn all of its pre-requisite files!

Disk Sanitization Steps

About

This tutorial covers the prerequisites and step-by-step installation process for the open-source help desk ticketing system, osTicket.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published