- osTicket (Help Desk Ticketing System)
- System Administration
- Microsoft Azure (Cloud computing)
- Microsoft Remote Desktop
- Internet Information Services (IIS)
To get rid of the ⚠️ Please take a minute to delete setup directory (../setup/) for security reasons.
message:
- Navigate to
C:\inetpub\wwwroot\osTicket
, right-click thesetup
folder and then clickDelete
Now that osTicket is successfully installed from scratch, it is time to do some configuration and system administration work. To start this off, we will create a new Role in osTicket called "Master Admin". This will be the highest level administrator that has every single permission available to them. Roles are used to determine an Agent's permissions. Generally, most Agents will not have every single permission as the Master Admin does.
-
Open
http://localhost/osTicket/scp/logs.php
in a web browser, enter the correct credentials -
Navigate to
Agents
>📋 Roles
>(+) Add New Role
-
In the
📄 Definition
tab:- In the Name: field, enter the desired role. In this case, it is
Master Admin
- Optionally, add any desired details regarding the new role in the Internal Notes field
- In the Name: field, enter the desired role. In this case, it is
-
In the
🔒 Permissions
tab, give all available permissions to the Master Admin:- ✅
Assign — Ability to assign tickets to agents or teams
- ✅
Close — Ability to close tickets
- ✅
Create — Ability to open tickets on behalf of users
- ✅
Delete — Ability to delete tickets
- ✅
Edit — Ability to edit tickets
- ✅
Edit Thread — Ability to edit thread items of other agents
- ✅
Link — Ability to link tickets
- ✅
Mark as Answered — Ability to mark a ticket as Answered/Unanswered
- ✅
Merge — Ability to merge tickets
- ✅
Post Reply — Ability to post a ticket reply
- ✅
Refer — Ability to manage ticket referrals
- ✅
Release — Ability to release ticket assignment
- ✅
Transfer — Ability to transfer tickets between departments
- ✅
Each Agent is appointed a specific department which is determined by their assigned role within the helpdesk. For now, we'll just create a "System Administrators" department where the Master Admins will be designated. Various other settings such as email settings, service level agreements (SLAs), and managers can also be configured in the Departments
tab.
-
Navigate to
Agents
>🧑💻 Departments
>(+) Add New Department
-
In the Name: field, enter
System Administrators
-
Scroll to the bottom of the page and click the orange
Create Dept
button
Teams enable cross-departmental collaboration by aggregating skilled agents from various units. This structure facilitates the creation of specialized groups. For instance, you can develop a help topic related to a specific product and assign it to a team of agents with expertise in that product. In this demonstration, we'll create a "Level II Support Team" to illustrate this concept.
-
Navigate to
Agents
>👨🏻👨🏾 Teams
>(+) Add New Team
-
In the Name: field, enter
Level II Support
-
At the bottom of the page, click the orange
Create Team
button
Out-of-the-box installations of osTicket require users to be registered and logged-in before they can create tickets. Since this isn't always ideal, the setting regarding this functionality needs to be adjusted.
-
Navigate to
Settings
>👥 Users
> Tick ✅Require registration and login to create tickets
-
At the bottom of the page, click the orange
Save Changes
button
Next, we'll proceed to create Agents. Agents are the helpdesk staff responsible for resolving tickets. Each Agent is assigned a primary department and role for tickets within their designated area. Agents can be granted access to multiple departments, with potentially different roles in each. The Access, Permissions, and Teams tabs are used to adjust access levels, manage permissions, and assign teams for each staff member.
-
Navigate to
Agents
>👤 Agents
>(+) Add New Agent
-
In the
Account
tab, fill out the Name:, Email Address:, and Username: fields for the particular Agent being added. Do the same for any desired settings in theAccess
andPermissions
tabs as well -
At the bottom of the page, click the orange
Create
button -
Repeat these steps until as many Agents as desired have been added
Note
While creating an administrator-level Agents (e.g. System Administrators, Managers), permit them expanded access to the Support department so that they are able to assign tickets to support-level employees.
-
In the Admin panel of osTicket, navigate to
Agents
>👤 Agents
> and then select that Agent that needs their password set -
Under the Authentication section, click
🔄 Set Password
-
Uncheck ◻️
Send the agent a password reset email
-
In the
New Password
andConfirm Password
fields, enter a matching secure password and then click theUpdate
button -
Verify that the ◻️
Require password change at next login
is unchecked
Note
The steps above outline how an admin would manually set an Agent's password. However, the two boxes that were left unchecked are alternative methods for the Agent to set their own password instead.
SLA (Service Level Agreement) Plans define the expected resolution time for specific ticket types. Each SLA incorporates a schedule and a grace period. For instance, in our example, the SEV-A (Severity A) SLA operates on a 24/7 schedule with a one-hour grace period. This structure ensures clear expectations for ticket resolution timeframes.
-
Navigate to
Manage
>📚 SLA
>(+) Add New SLA Plan
-
Fill out the information in accordance to the SLA plan of choice
-
At the bottom of the page, click the orange
Add Plan
button
Help Topics facilitate ticket categorization for users. For example, we can create a "Business Critical Outage" topic, which could be used for scenarios such as customers being unable to access mobile banking services. This categorization streamlines the ticket management process and prioritization.
-
Navigate to
Manage
>❓ Help Topics
>(+) Add New Help Topic
-
In the Topic: field, enter the relevant information for the topic of choice
-
At the bottom of the page, click the orange
Add Topic
button