masqmail

view docs/simple-relay-setup @ 213:3f0b10d41938

find changesets by author, revision, files, or words in the commit message
added authors of contributed parts to AUTHORS
author meillo@marmaro.de
date Sun, 18 Jul 2010 22:40:09 +0200
parents
children 9814e75de61c
line source
1 Simple Setup
2 ============
3
4 You want
5 --------
6
7 - submit mail on stdin by calling masqmail on the commandline
8 - submit mail with SMTP from the local machine
9 - let masqmail deliver mail locally to the system mailboxes /var/mail/*
10 - let masqmail forward non-local mail through a smart host
11
12 This is like the simple-local-setup plus the forwarding.
13
14
15 Set up
16 ------
17
18 Follow the description in INSTALL.
19
20 A common configure call would be:
21
22 ./configure --enable-auth --enable-ident
23
24
25 Configuration
26 -------------
27
28 You need a config file like this one:
29
30 host_name = "foo.example.org"
31 online_routes.default = /etc/masqmail/default.route
32
33 (Substitute a real hostname, of course.)
34
35 Addionally you need to create the route config file like:
36
37 protocol = smtp
38
39 # where to relay to; the address and port of the smart host
40 mail_host = "mail.gmx.net:25"
41 # use the wrapper to enable encryption
42 #wrapper = "openssl s_client -quiet -connect mail.gmx.net:465 2>/dev/null"
43
44 do_correct_helo = true
45
46 # rewrite the From addresses to ones visible from the outside
47 map_return_path_addresses = "meillo: schnalke4@gmx.de"
48 map_h_from_addresses = "meillo: markus schnalke <schnalke4@gmx.de>"
49
50 # it's good to use "login" only if the connection is encrypted
51 auth_name = "login"
52 #auth_name = "cram-md5"
53 auth_login = "UID_OR_EMAIL_ADDRESS"
54 auth_secret = "PASSWORD"
55
56
57
58 Starting the daemon
59 -------------------
60
61 Listening for SMTP connections on a port requires masqmail to run as
62 daemon. You probably want to start masqmail as daemon each time the
63 system comes up. How you have to do that is system dependent.
64 /etc/rc.local is a good try to add the daemon call, because this file
65 seems to be frequently available.
66
67 /usr/local/sbin/masqmail -bd -q10m
68
69 This starts masqmail in daemon mode and does a queue run every ten
70 minutes.
71
72
73 Check the setup
74 ---------------
75
76 Like in simple-local-setup plus ...
77
78 Send a mail to a remote location:
79
80 $ echo "some text" | mail foo@somewhereelse.example.org
81
82 Check if it is queued:
83
84 $ masqmail -bp
85
86 Deliver it with:
87
88 $ masqmail -qo default
89
90 Check the queue contents again.
91
92 You need to do such queue runs for online routes explicitely. For
93 instance by cron.
94
95
96 Automatic queue runs
97 --------------------
98
99 You can also tell masqmail to send queued mails through a route each
100 time the daemon does a queue run. Therefor you need to tell masqmail
101 that it is online and can use the default route to deliver mail.
102
103 Add this to masqmail.conf:
104
105 online_detect = "pipe"
106 online_pipe = "/bin/echo default"
107
108 Now masqmail will send online mail automatically through the default
109 route, each time it does a queue run (every ten minutes).
110
111
112 In case of problems
113 -------------------
114
115 Have a look at the log file: /var/log/masqmail/masqmail.log
116
117 Set the debug level in masqmail.conf, restart the daemon, redo the
118 test, and look at the debug file: /var/log/masqmail/debug.log
119
120 If you use a wrapper, test it manually and interactively on the
121 command line.
122
123 Ask on the mailing list: <masqmail@marmaro.de>
124
125
126
127 meillo