Home  |  Features  |  Downloads  |  Forums  |  Support  |  Contact Us

From osTicket Wiki

Jump to: navigation, search

Email Piping

The email piping is a technique of sending email message as an input to a program rather than appending the message to the mailbox file, allowing for real-time email delivery and handling. Every mail server has its own rules and procedures for mail delivery, making it hard to provide common instructions for configuring an MTA. You should refer to your hosting manual or contact your hosting provider for email piping instructions if none of the methods below works for you.

  • osTicket supports both remote and local piping
  • Email piping must be enabled in admin panel

Contents

Local Piping

Local piping refers to the case where osTicket is installed on a server also handling your emails. Most shared hosting users fall into this category.

Setting up aliases in cPanel

Add a forwarding rule for each of the email addresses to /path/to/api/pipe.php. For example forward support@domain.com to "|/path/to/api/pipe.php"

CPANEL 10/11 Instructions

Set your piping path to:   "|/usr/bin/php -q /home/USERNAME/public_html/plhelp/api/pipe.php"

(change USERNAME to your actual cpanel login username in lowercase)

  • Don't forget the quotes.
  • Make pipe.php executable chmod 764 pipe.php
  • Enable email piping in admin panel Settings -> preference

Setting up aliases with qmail

Create/Edit your .qmail-* for the domain you wish to forward and add a forwarding rule to /path/to/api/pipe.php. For example for support@domain.com .qmail-support file should contain |/path/to/api/pipe.php

Setting up aliases for sendmail

Modify your aliases file by adding support: root, |/path/to/api/pipe.php and run newaliases.

Setting up aliases in .procmailrc

    :0 c
    * ^To.*support@domain.com
    |/path/to/api/pipe.php

Remote Piping

Remote piping is useful when osTicket installation and the mail server are on two separate machines. To maintain logic in one place remote piping is done over HTTP post. osTicket ships with two scripts to help you accomplish this task; automail.php and automail.pl. Both accomplish the same task by posting to http://www.yourdomain.com/osticket/api/pipe.php (replace osticket with the folder name where you installed osticket)

  • Remote host IP must be white listed
  • Valid API key required
  • Follow local piping instructions above to pipe emails to remote script which will in turn post to osTicket