Installing osTicket on an Uberspace

About

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.

Installation

  1. 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“.
  2. 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:

    [html]$ 
    [html]$ 
    cd ~/html
    mkdir osticket
    cd osticket
  3. 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).
  4. 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.
  5. Click on „Continue“.
  6. 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
    [osticket]$ 
    cp include/ost-sampleconfig.php include/ost-config.php
  7. Again, click on „Continue“.
  8. 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.cnf file on your Uberspace.
  9. Start the installation.
  10. Remove write access from the configuration file as instructed on the shown page via
    [osticket]$ 
    chmod 0644 include/ost-config.php
  11. Delete the setup directory:
    [osticket]$ 
    rm -r setup/
  12. Now you can login on <your-domain>/osticket/scp/settings.php

Next Steps

Check the Post-install setup guide from osTicket’s Wiki.

Tips

E-Mail Piping

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-<version>/bin/php, e.g., /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"
This entry was posted in General and tagged , . Bookmark the permalink.
Subscribe to comments on this post via RSS-2.0 feed

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.

Time limit is exhausted. Please reload CAPTCHA.