osTicket is an open source, web-based ticket system. This article explains the steps required to install osTicket on an Uberspace. The information in this article is mostly based on the official installation instructions but includes a few smaller additional notes while omitting irrelevant parts.
- Download the latest version from http://osticket.com/downloads.php. Open the link and click on the download button for the latest osTicket Core. On the following page you can optionally fill in some personal information and click on Download or proceed directly to the download by clicking on „No Thanks“.
- Create the web directory for your osTicket installation, e.g.,
<your-domain>/osticket. In this article, we will install osTicket in a directory under the default domain. If you’d like to install it under a subdomain please adapt the steps accordingly. To create the directory, first go to your web root and then create and switch to the directory:
- Unzip the osTicket zip file on your computer and upload the contents of the upload directory to the web directory you created in the previous step (e.g., via FTP).
- Open the web directory, e.g.,
<your-domain>/osticket, in your web browser to start the installation. All requirements should already be fulfilled and marked with green ticks.
- Click on „Continue“.
- The following page tells you that the configuration file is missing and the solution for this problem, i.e., copying the sample configuration file via
cp include/ost-sampleconfig.php include/ost-config.php
- Again, click on „Continue“.
- Enter the requested information, e.g., the name of your support system, admin user login details and database credentials. Make sure to not use a „predictable“ username for the admin user, e.g., „admin“, because it won’t be accepted. You can find your database password in the
~/.my.cnffile on your Uberspace.
- Start the installation.
- Remove write access from the configuration file as instructed on the shown page via
chmod 0644 include/ost-config.php
- Delete the setup directory:
rm -r setup/
- Now you can login on
Check the Post-install setup guide from osTicket’s Wiki.
If you want to use osTicket’s email piping feature please note that the
pipe.php script expects the PHP interpreter to be located at
/usr/bin/php. However, on an Uberspace the PHP interpreters are installed in
/package/host/localhost/php-5.6.5/bin/php. Changing the first line of the
pipe.php script accordingly is sufficient.
E-Mail piping with Maildrop
If you’re already using maildrop for spam filtering with SpamAssassin and/or DSPAM you’ll have .qmail file with a
|maildrop <configuration file> line. Using maildrop, you can send a copy of an incoming email to osTicket’s pipe but still deliver it to the main inbox, too. Based on the example configuration at the end of Uberspace Wiki’s maildrop article, you can insert a cc command before the final
to "$MAILDIR" command:
[...] cc "|/var/www/virtual/<username>/html/osticket/api/pipe.php"; # and finally, deliver everything that survived our filtering to "$MAILDIR"