masqmail

annotate docs/simple-relay-setup @ 214:ecd8d737d78e

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