September 5, 2008, Friday, 248

Installation

From osTicket Wiki

Jump to: navigation, search


Installation Process

osTicket comes with it's own web-based installer to help guide you through the installation process without the frustration. While the installer provides step by step guide during the installation process it is important and helpful to have general knowledge about Web servers, PHP and MySQL.

Prerequisites

To install osTicket, your web server must have PHP 4.3 (or better) and MySQL 4.1 (or better) installed. If you are unsure whether your server meets these requirements, please check with your host or webmaster before proceeding with the installation.

You will need one MySQL database with valid username, password and hostname handy during installation. The database username must have permission to CREATE, DROP and ALTER tables. If you are unsure whether you have these details or if your username has sufficient permissions, please consult your host or database admin before proceeding.

Getting Started

At this point you should have downloaded latest osTicket. Uncompress the files and upload files and directories in upload directory to a directory of your choice on your server. For example /osticket/, /helpdesk/ or /support/ depending on your preference. Basic knowledge of using FTP is a plus at this stage. If you don't know how to use FTP, we would recommend you read the documentation supplied with your FTP client and learn the basics of uploading and setting permissions on files.

osTicket installer needs to be able to write and modify ostconfig.php found in the upload's root directory. Change the permission settings for the ostconfig.php file so that it is writable by the webserver.

Using installation script

Once all of the above steps are complete, you can complete the installation and basic setup in a web browser. You can invoke the installer by simply browsing the osTicket URL e.g http://www.yourdomain.com/support. Alternatively you can enter the URL to it into your browser address bar e.g http://www.yourdomain.com/support/setup/

osTicket's installation script will attempt to auto-detect paths and any permission issues. Please follow the instructions to finish up the installation process.

  • If the script spots any configuration errors then it will not allow you to continue until the errors are corrected.
  • If everything checks out, you will be presented with a form to fill in the information that osTicket now requires.
  • If any errors occurs, go back and check the data entered.
  • On valid data the script will create and populate the database plus write a configuration file.

Note that the installer performs basic configuration required to get osTicket up and running. Further configuration is required, post-install, to make the system fully functional.

Finishing Up

If the setup script has finished running with no errors, then congratulations osTicket is installed. Your next step should be to fully configure your new support ticket system for use, but before you get to it please take a second to cleanup.

  • Change permission of ostconfig.php to 644
  • Delete install directory.

We are done! You can now log in with the username and password you created during the install process. After a successful log in, you can proceed with the next step, Post-Install Setup.

Having trouble

We can help install and configure osTicket to your needs. Please learn more about our professional installation services.