Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 

Repository files navigation

osTicket logo

osTicket - Post-Install Configuration

This tutorial outlines the post-install configuration of the open-source help desk ticketing system osTicket.

Environments and Technologies Used

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

Operating Systems Used

  • Windows 10 (21H2)

Post-Install Configuration Objectives

  • Create Email Routing
  • Configure Roles, Departments, Agents, and Teams
  • Set up Service Level Agreements (SLAs)
  • Configure Help Topics
  • Create End-User(s)
  • Test Ticket Creation

Access Information

Before You Begin

  • Acknowledge Agent Panel vs Admin Panel

image image

In osTicket, the Admin Panel is for system-wide configuration and management, while the Agent Panel is for managing tickets and interacting with users. Essentially, the Admin Panel is for managing the help desk itself, and the Agent Panel is for the agents who use it to provide support.


Configuration Steps

Step 1: Create Email Routing:

  • Go to Admin PanelEmailsSettings
  • Enable email piping to convert emails to tickets

  • (Optional) In the Admin Panel navigate to SettingsUsers
  • Make sure "Require registration & login to create tickets" is unchecked to allow anyone to create tickets


Step 2: Configure Roles / Departments / Agents / Teams

image

Roles: Permissions granted to Agents per Department that they have access to. Each Role has a set of permissions that can be checked/unchecked for agents given that Role in association with a Department they have access to.

  • Go to Admin PanelAgentsRoles
  • Click + Add New Role
  • Under the Definition tab, create a Role such as:

Admin
Supervisor
Support Agent

  • Continue to the Permissions tab → Tickets, select all relevant checkboxes to assign the appropriate permissions
  • Do the same for the Tasks & Knowledgebase tabs
  • Click Add Role once the desired permissions are selected

Departments: Tickets are routed through Departments in the help desk, which organize and direct requests to the appropriate staff members.

  • Go to Admin PanelAgentsDepartments
  • Click + Add New Department
  • In the Parent dropdown menu select Top Level Department
  • Create departments like:

IT Support
HR
Billing

  • Configure the remaining optional fields, then navigate to the Access tab to add relevant agents

Agents: Staff are given access to the help desk with the intent to respond and resolve the tickets. When adding an Agent to the help desk, they will need to be assigned to a Primary Department and given a Primary Role for the Tickets/Tasks routed to that department.

  • Go to Admin PanelAgentsAgents
  • Click + Add New Agent
  • Under the Accounts tab, create Agents as desired
  • Proceed to the Access tab to select Departments & Roles
  • Continue to Permissions tab to assign the appropriate permissions
  • Lastly, under the Teams tab, assign the appropriate agents to their respective teams (configured next)

Teams: Allows pulling agents from different Departments and organizing them to handle a specific issue or user via a Help Topic or Ticket Filter.

  • Go to Admin PanelAgentsTeams
  • Click + Add New Team
  • Under the Teams tab, create a Team such as:

Customer Care Team
VIP Support Team
Quality Assurance Team

  • Proceed to the Members tab to select Agents for current Team
  • Click Create Team to finish setup



Step 3: Configure SLAs (Service Level Agreements)

image

  • Go to Admin PanelManageSLA
  • Click + Add SLA Plan
  • Create SLAs such as:

Critical = 1 Hour
High Priority = 4 Hours
Normal = 8 Hours

  • Configure Grace Period & Schedule for each Plan
  • Click + Add Plan to finish setup



Step 4: Configure Help Topics:

  • Go to Admin PanelManageHelp Topics
  • Click + Add New Help Topic
  • Create Topics such as:

Business Critical Outage
Personal Computer Issues
Equipment Request
Password Reset
Other

  • Choose appropriate Parent Topic
  • Click + Add Topic to finish setup



Step 5: Create End-User(s):

  • Go to Agent PanelUsersUser Directory
  • Click + Add User
  • Create custom User(s)
  • Click + Add User to finish setup



Step 6: Test Ticket Creation:

image

  • Create a test ticket via email or web form. Go to ➤ http://localhost/osTicket/
  • Click Open a New Ticket
  • Enter required contact details
  • Choose a Help Topic & make a brief description in the issue summary
  • Click Create Ticket
  • Confirm that the ticket appears in the admin panel
  • Test response and escalation settings



Congratulations! Hopefully, the configuration has been completed without any errors.


Closing Thoughts

Installing and configuring osTicket provides me with hands-on practice in the full help-desk flow, including the web stack, email piping, permissions, SLAs, form building, automations, and maintenance. That end-to-end work mirrors how IT teams run service operations: triage → escalate → resolve → report.


About

osTicket - Post-Installation Setup

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors