Put in remaining pages and wiki contents.
[ikiwiki.git] / docs / handbook / handbook-mail-advanced.mdwn
1 \r
2 \r
3 ## 20.6 Advanced Topics \r
4 \r
5 The following section covers more involved topics such as mail configuration and setting up mail for your entire domain.\r
6 \r
7 ### 20.6.1 Basic Configuration \r
8 \r
9 Out of the box, you should be able to send email to external hosts as long as you have set up `/etc/resolv.conf` or are running your own name server. If you would like to have mail for your host delivered to the MTA (e.g.,  **sendmail** ) on your own DragonFly host, there are two methods:\r
10 \r
12 * Run your own name server and have your own domain. For example, `dragonflybsd.org`\r
14 * Get mail delivered directly to your host. This is done by delivering mail directly to the current DNS name for your machine. For example, `example.dragonflybsd.org`.\r
15 \r
16 Regardless of which of the above you choose, in order to have mail delivered directly to your host, it must have a permanent static IP address (not a dynamic address, as with most PPP dial-up configurations). If you are behind a firewall, it must pass SMTP traffic on to you. If you want to receive mail directly at your host, you need to be sure of either of two things:\r
17 \r
19 * Make sure that the (lowest-numbered) MX record in your DNS points to your host's IP address.\r
21 * Make sure there is no MX entry in your DNS for your host.\r
22 \r
23 Either of the above will allow you to receive mail directly at your host.\r
24 \r
25 Try this:\r
26 \r
27     \r
28     # hostname\r
29     example.dragonflybsd.org\r
30     # host example.dragonflybsd.org\r
31     example.dragonflybsd.org has address 204.216.27.XX\r
32 \r
33 \r
34 If that is what you see, mail directly to `<[mailto:yourlogin@example.dragonflybsd.org yourlogin@example.dragonflybsd.org]>` should work without problems (assuming  **sendmail**  is running correctly on `example.dragonflybsd.org`).\r
35 \r
36 If instead you see something like this:\r
37 \r
38     \r
39     # host example.dragonflybsd.org\r
40     example.dragonflybsd.org has address 204.216.27.XX\r
41     example.dragonflybsd.org mail is handled (pri=10) by hub.dragonflybsd.org\r
42 \r
43 \r
44 All mail sent to your host (`example.dragonflybsd.org`) will end up being collected on `hub` under the same username instead of being sent directly to your host.\r
45 \r
46 The above information is handled by your DNS server. The DNS record that carries mail routing information is the ***M***ail e***X***change entry. If no MX record exists, mail will be delivered directly to the host by way of its IP address.\r
47 \r
48 The MX entry for `freefall.FreeBSD.org` at one time looked like this:\r
49 \r
50     \r
51     freefall            MX      30      mail.crl.net\r
52     freefall            MX      40      agora.rdrop.com\r
53     freefall            MX      10      freefall.FreeBSD.org\r
54     freefall            MX      20      who.cdrom.com\r
55 \r
56 \r
57 As you can see, `freefall` had many MX entries. The lowest MX number is the host that receives mail directly if available; if it is not accessible for some reason, the others (sometimes called ***backup MXes***) accept messages temporarily, and pass it along when a lower-numbered host becomes available, eventually to the lowest-numbered host.\r
58 \r
59 Alternate MX sites should have separate Internet connections from your own in order to be most useful. Your ISP or another friendly site should have no problem providing this service for you.\r
60 \r
61 ### 20.6.2 Mail for Your Domain \r
62 \r
63 In order to set up a ***mailhost*** (a.k.a. mail server) you need to have any mail sent to various workstations directed to it. Basically, you want to ***claim*** any mail for any hostname in your domain (in this case `*.dragonflybsd.org`) and divert it to your mail server so your users can receive their mail on the master mail server.\r
64 \r
65 To make life easiest, a user account with the same ***username*** should exist on both machines. Use [adduser(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#adduser&section8) to do this.\r
66 \r
67 The mailhost you will be using must be the designated mail exchanger for each workstation on the network. This is done in your DNS configuration like so:\r
68 \r
69     \r
70     example.dragonflybsd.org    A       204.216.27.XX           ; Workstation\r
71                         MX      10 hub.dragonflybsd.org ; Mailhost\r
72 \r
73 \r
74 This will redirect mail for the workstation to the mailhost no matter where the A record points. The mail is sent to the MX host.\r
75 \r
76 You cannot do this yourself unless you are running a DNS server. If you are not, or cannot run your own DNS server, talk to your ISP or whoever provides your DNS.\r
77 \r
78 If you are doing virtual email hosting, the following information will come in handy. For this example, we will assume you have a customer with his own domain, in this case `customer1.org`, and you want all the mail for `customer1.org` sent to your mailhost, `mail.myhost.com`. The entry in your DNS should look like this:\r
79 \r
80     \r
81     customer1.org               MX      10      mail.myhost.com\r
82 \r
83 \r
84 You do ***not*** need an A record for `customer1.org` if you only want to handle email for that domain.\r
85 \r
86  **Note:** Be aware that pinging `customer1.org` will not work unless an A record exists for it.\r
87 \r
88 The last thing that you must do is tell  **sendmail**  on your mailhost what domains and/or hostnames it should be accepting mail for. There are a few different ways this can be done. Either of the following will work:\r
89 \r
91 * Add the hosts to your `/etc/mail/local-host-names` file if you are using the `FEATURE(use_cw_file)`.\r
93 * Add a `Cwyour.host.com` line to your `/etc/mail/sendmail.cf`.\r
94 \r
95 \r
96 \r
97 CategoryHandbook\r
98 CategoryHandbook-email\r