Request Tracker

Note: This document has been tested on Alpine Linux 2.2.2, but contains some packages which are currently in the [edge/testing repository].
Note: Use a computer with at least 512MB of RAM.

RT with basic email support

This guide will get a basic rt4 setup working that will allow inbound emails to create/update issues, and assumes that you have a working postfix setup already.

add edge/main and edge/testing repos to /etc/apk/repositories

printf "http://nl.alpinelinux.org/alpine/edge/main\nhttp://nl.alpinelinux.org/alpine/edge/testing" >> /etc/apk/repositories apk update

apk add lighttpd fcgi postgresql rt4 php php-cli postfix postfix-pcre msmtp
Edit /etc/lighttpd/lighttpd.conf and enable fastcgi
/etc/init.d/postgresql setup
/etc/init.d/postgresql start
su - postgres -c "createuser -P"

Enter name of role to add: rt_user
Enter password for new role: rtpass
Enter it again: rtpass
Shall the new role be a superuser? (y/n) n
Shall the new role be allowed to create databases? (y/n) y
Shall the new role be allowed to create more new roles? (y/n) y

cp /etc/rt4/RT_Config.pm /etc/rt4/RT_SiteConfig.pm
chmod 644 /etc/rt4/RT_SiteConfig.pm
/etc/rt4/RT_SiteConfig.pm change to use Pg instead of mysql and change DatabasePassword to correspond to the password created for rt_user in postgresql.
/usr/sbin/rt-setup-database --action init
rt-server
Test and make sure that you can access rt using the built-in webserver first.
Tools -> Configuration -> Queues -> Create... Give it a name like 'support', which you'll use in the next sections (including the email address)
Add to /etc/postfix/main.cf:

virtual_alias_maps = regexp:/etc/postfix/rt4-aliases
transport_maps = regexp:/etc/postfix/rt4-transport

Create /etc/postfix/rt4-aliases (replacing example.com):

/^(.*)@example.com$/   $1

Create /etc/postfix/rt4-transport:

/^support$/             rt4-support:

Add to /etc/postfix/master.cf:

rt4-support   unix    -       n       n       -       -       pipe    flags=DORhu     user=postgres    argv=/usr/bin/rt-mailgate --queue support --action correspond --url http://ip.addr.of.interface/

Allow users to create tickets by email by checking all General Rights for group Everyone in Tools -> Configuration -> Global -> Group Rights
Setup outbound emails:
/etc/rt4/RT_SiteConfig.pm:

Set($MailCommand, "sendmailpipe");
Set($SendmailPath, "/usr/sbin/sendmail");

Warning: Instructions below this warning haven't yet been tested

Stop rt-server
/etc/init.d/lighttpd start
/etc/lighttpd/lighttpd.conf (add to the end):

fastcgi.server = ( "/rt" =>
       ( "localhost" =>
                  (
                           "port" => 80,
                           "bin-path" => "/usr/sbin/rt-server.fcgi",
                           "check-local" => "disable"
                  )
       )
)

Optional: Mlmmj support

Warning: This section hasn't yet been tested

apk add mlmmj
adduser mlmmj
mkdir /var/spool/mlmmj
mlmmj-make-ml.sh -L support
/etc/postfix/main.cf:

virtual_alias_maps = regexp:/etc/postfix/rt4-aliases,
 regexp:/etc/postfix/mlmmj-lists
transport_maps = regexp:/etc/postfix/rt4-transport,
 regexp:/etc/postfix/mlmmj-transport

/etc/postfix/mlmmj-lists:

/^(support1.*)@example.com/   $1

/etc/postfix/mlmmj-transport:

/^(support1).*$/             mlmmj-support:

/etc/postfix/master.cf:

mlmmj-support               unix    -       n       n       -       -       pipe    flags=DORhu     user=mlmmj      argv=/usr/bin/mlmmj-recieve -F -L /var/spool/mlmmj/support/

set outbound default email for tickets to be support1@example.com

Tools -> Configuration -> Queues -> Select -> Support
Change "reply address" and "comment address" to support1@example.com (replacing support@example.com)