1 Setting up MTAs for Debbugs
2 ===========================
6 Be sure to set the $gMailer variable correctly in /etc/debbugs/config.
7 The options are (all lower case) exim, qmail and sendmail.
11 I've seen two types of setting up Exim used.
13 1) If the machine is dedicated and all e-mail goes to the debbugs script,
14 add this in the transport section:
18 user = <some non-root user>
19 group = <some non-root group>
20 command = /usr/lib/debbugs/receive
23 Do not use root user/group, it is very unsafe. You could even add a new
24 (locked) account "debbugs", and use that. Either user or group needs
27 And AT THE TOP of the directors section, add this:
31 transport = debbugs_pipe
32 local_parts = submit:bugs:maintonly:quiet:forwarded:done:close:request:submitter:control:^\\d+
34 2) If the domain is a virtual host on a machine that needs it, there are
35 many ways of handling it. I think the neatest was to use the above
36 transport and director, except to add the following line to the
39 domains = <domain name>
41 Alternatively, Chad Miller <cmiller@surfsouth.com> suggests:
43 The method I discovered involved adding at the top of the routers section:
47 transport = debbugs_transport
48 route_list = "bugs.foo.bar;bugs.baz.quux"
50 where bugs.foo.bar and bugs.baz.quux are mail-domains for which I want to
51 receive bug requests only.
52 Next, add anywhere in the transports section:
56 command = /usr/lib/debbugs/receive
57 user = <some non-root user>
58 group = <some non-root group>
59 current_directory = /etc/debbugs
60 home_directory = /var/lib/debbugs/spool
62 (current_directory may need to be /var/lib/debbugs/spool, depending on
65 Next, the mail domains MUST NOT be in the "local_domains" list!
66 Instead, we MUST put them in the "relay_domains" list.
68 Essentially, this tells exim that we agree ("relay_domains") to relay
69 mail for those zones ("debbugs_router") and "send" the mail using a pipe
70 ("debbugs_transport").
74 From Tommi Virtanen (tv@debian.org), amended by Daniel Ruoso
77 Here's my suggestion for safe & secure installation under qmail:
79 Create a separate user for the debbugs system.
80 # adduser --system --group --home /home/misc/debbugs debbugs
81 Give control of a virtual domain to that user
82 # echo bugs.example.com:debbugs >>/etc/qmail/virtualdomains
83 Give the user access to the bug databases
84 # chown -R debbugs:debbugs /var/lib/debbugs/*
85 Set the BTS owner address
86 # echo '&me@my.example.com' >~debbugs/.qmail-owner
87 Make the BTS handle it's mail
88 # echo '|/usr/lib/debbugs/receive' >~debbugs/.qmail-default
89 Reload the virtualdomains config file
90 # /etc/init.d/qmail reload
95 From Wichert Akkerman (wakkerma@debian.org):
97 First of all make sure that debbugs is configured for sendmail: look
98 at /etc/debbugs/config for the $gMailer variable and make sure it is
101 Next make sure that your DNS is configured properly. For sendmail
102 this means you cannot use a CNAME for the debbugs-domain, since that
103 gets remapped to the canonical name and thus bypasses the mailertable
104 we need. This is an example of a working DNS entry:
106 bugs IN 192.168.2.100
107 0 MX mailgate.mors.net
108 HINFO "PC Pentium" "Debbugs 2.0"
110 Now that that is finished it is time to configure sendmail itself. First
111 make sure that sendmail does not consider the debbugs-domain as local by
112 making sure it is not listed in /etc/mail/sendmail.cw . Now start your
113 favourite editor and load /etc/mail/sendmail.mc . We need to make two
115 there: add a mailertable and define the debbugs delivery agent. The
116 mailertable is needed to tell sendmail to use the debbugs to deliver mail
117 destined for your debbugs server.
119 To enable the mailertable put the following line in your sendmail.mc file:
121 FEATURE(mailertable, `text -o /etc/mail/mailertable')dnl
123 This tells sendmail to use the textfile /etc/mail/mailertable as the
124 database containing the table. You can also use a db database if you
125 want to add a lot of entries in there since that is faster. If you
126 want to do that use the following line instead:
128 FEATURE(mailertable, `hash -o /etc/mail/mailertable.db')dnl
130 You can create the database using the following command:
132 makemap hash mailertable.db < mailertable
134 Where mailertable is the textfile containing the data.
136 The next thing we need to do is tell sendmail about the debbugs delivery
137 agent. To do this add the following two lines to your sendmail.mc file,
138 preferably just after the MAILER commands:
140 Mdebbugs, P=/usr/lib/debbugs/receive, F=SDFMlhudb80, U=<uid>:<gid>,
141 S=10/30, R=20/30, D=/tmp, T=DNS/RFC822/X-Unix, A=receive $u
143 Where <uid> and <gid> should be replaced with the user and group you
146 Okay, we are now done with sendmail.mc and are ready to add the entry
147 in your mailertable. Save sendmail.mc and load /etc/mail/mailertable in
148 your editor. Put a single line in there just like this one:
150 bugs.your.net debbugs:yournet
152 (please note there are tabs between those words). This tells sendmail that
153 mail destined for the host bugs.your.net should be handled by the debbugs
154 delivery agent using yournet as the hostname. If you decided to use a db
155 database instead of the plain textfile don't forget to run makemap now!
157 Now the final step: run sendmailconfig to regenerate sendmail.cf and
158 restart sendmail with the new configuration. Your system should now
159 be up and running. Congratulations!
163 It seems Bdale isn't around currently, so I'll just mail this
164 here directly. This is a short description of how to get debbugs
165 working with postfix. If someone can verify this and give me some
166 feedback if would be appreciated.
168 Lets assume that you are going to install bugs.domain.net, and you
169 are going to run it on the machine master.domain.net.
171 DNS setup: point the MX to the machine running debbugs:
173 bugs.domain.net MX 50 master.domain.net.
175 In /etc/postfix/main.cf enable the transport maps by inserting the
178 transport_maps = hash:/etc/postfix/transport
180 Now create /etc/postfix/transport and insert:
182 bugs.domain.net debbugs:
184 This tells postfix to use the debbugs transport agent to deliver any
185 mail send to bugs.domain.net. Now we need to make a database from that
186 that postfix can use:
188 # makemap hash transport
190 Now we need to teach postfix what the debbugs transport agent is. Edit
191 /etc/postfix/master.cf and add:
193 debbugs unix - n n - - pipe
194 flags=F user=debbugs argv=/usr/lib/debbugs/receive $recipient
196 This assumes that you are running debbugs with uid debbugs (the package
197 doesn't do that by default, but I generally chown /var/lib/debbugs/*
198 to a new debbugs account just to be safe).
200 Finally add bugs.domain.net to mydestination in main.cf:
202 mydestination = $myhostname localhost.$mydomain bugs.domain.org
204 Now that all this is done, restart postfix and it should be working..