input/doc/subdomains.mdwn

   1 Facilities offered to teams with dedicated debian.org subdomains
   2 ================================================================
   3
   4 Various teams have dedicated subdomains below debian.org (e.g
   5 release.debian.org, qa.debian.org, etc.). Associated to it,
   6 there's usually a website and e-mail addresses. The corresponding
   7 files are always in `/srv/foo.debian.org/` on the host allocated
   8 to the service by the DSA team.
   9
  10 Website
  11 -------
  12
  13 The Apache virtual host configuration usually resides in
  14 `/srv/foo.debian.org/apache.conf`. After having changed the configuration,
  15 you should be able to reload apache with
  16 `sudo /usr/sbin/apache2-vhost-update` (provided that you have correctly
  17 configured a sudo password for the corresponding host).
  18
  19 Virtual Domain Mail Settings
  20 ----------------------------
  21
  22 The configuration of the mail service usually resides in
  23 `/srv/foo.debian.org/mail/`.
  24
  25 The following files enable you to create various email addresses:
  26
  27 * __aliases__: just like `/etc/aliases`, you can create e-mail addresses that
  28   forward the messages to one or more recipients.
  29 * __.forward-*__: qmail like forward files where `.forward-bar` defines how
  30   emails sent to bar@foo.debian.org are handled. It can be used to redirect
  31   mails to programs (eg. `|/srv/foo.debian.org/bin/processmail.pl`) or
  32   to mailboxes (eg. `/srv/foo.debian.org/mail/archive/bar`). Just put
  33   each destination on its own line.
  34 * __.forward-default__: like above, except it handles all the e-mail addresses
  35   that are not covered by an alias or another .forward-* file.
  36
  37 There are also various files that can be used to control the
  38 antispam measures of each email address:
  39
  40 * **callout_users**: a simple list of local parts (before the @) that should
  41   have callout sender verification applied.
  42 * **grey_users**: a simple list of local parts that should have
  43   greylisting applied.
  44 * **localonly**: a simple list of local parts that should only accept mail
  45   from debian.org hosts.
  46 * **neversenders**: a simple list of local parts (of the virtual domain) that
  47   should never appear as senders of mails.
  48 * **whitelist**: a colon separated list starting with "localpart:" of hosts
  49   and IP patterns to whitelist from any antispam measures configured in this
  50   directory.
  51 * **rbllist**: a colon separated list starting with "localpart:" of RBL
  52   lists to perform lookups in. Example for owner@foo.debian.org:
  53
  54         owner: zen.spamhaus.org : safe.dnsbl.sorbs.net
  55
  56 * **rhsbllist**: a colon separated list starting with "localpart:" of RHSBL
  57   lists to perform lookups in. This should be in the form of
  58   "RHSBL.example/$sender_address_domain". Example for owner@foo.debian.org:
  59
  60         owner: bogusmx.rfc-ignorant.org/$sender_address_domain : nomail.rhsbl.sorbs.net/$sender_address_domain
  61
  62 You can find examples of the last two files on any debian.org system
  63 in /var/lib/misc/thishost as mail-rbl and mail-rhsbl.
  64