decommission: puppet doesn't have a mysql db anymore
[mirror/dsa-wiki.git] / 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