annotate docs/simple-local-setup @ 216:84bf7a6b6ccd

added misc/list-versions This script helps to check if the versions numbers in the project are the same as the one for the release. This script is motivated by the 0.2.27 release in which masqmail introduces itself as being version 0.2.26.
author meillo@marmaro.de
date Mon, 19 Jul 2010 14:01:13 +0200
parents 3dff59a4e764
children 72653295b75d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
186
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
1 Simple Setup
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
2 ============
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
3
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
4 You want
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
5 --------
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
6
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
7 - submit mail on stdin by calling masqmail on the commandline
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
8 - submit mail with SMTP from the local machine
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
9 - let masqmail deliver mail locally to the system mailboxes /var/mail/*
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
10
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
11 You have luck, because this is what masqmail does by default.
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
12
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
13
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
14 Set up
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
15 ------
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
16
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
17 Follow the description in INSTALL.
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
18
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
19 A common configure call would be:
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
20
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
21 ./configure --enable-auth --enable-ident
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
22
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
23
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
24 Configuration
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
25 -------------
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
26
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
27 You just need a minimal config file, having one line:
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
28
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
29 host_name = "foo.example.org"
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
30
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
31 (Substitute a real value, of course.)
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
32
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
33
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
34 Starting the daemon
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
35 -------------------
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
36
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
37 Listening for SMTP connections on a port requires masqmail to run as
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
38 daemon. You probably want to start masqmail as daemon each time the
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
39 system comes up. How you have to do that is system dependent.
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
40 /etc/rc.local is a good try to add the daemon call, because this file
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
41 seems to be frequently available.
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
42
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
43 /usr/local/sbin/masqmail -bd -q10m
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
44
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
45 This starts masqmail in daemon mode and does a queue run every ten
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
46 minutes.
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
47
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
48
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
49 Check the setup
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
50 ---------------
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
51
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
52 Ensure you have the sendmail links correct:
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
53
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
54 $ ls -l /usr/lib/sendmail /usr/sbin/sendmail
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
55 lrwxrwxrwx 1 root root 25 2010-03-06 13:50 /usr/lib/sendmail -> /usr/local/sbin/masqmail*
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
56 lrwxrwxrwx 1 root root 25 2010-03-06 13:50 /usr/sbin/sendmail -> /usr/local/sbin/masqmail*
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
57
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
58 Send a mail to yourself:
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
59
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
60 $ echo "some text" | mail `whoami`
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
61
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
62 Check if the mail was delivered (then delete it and quit):
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
63
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
64 $ mail
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
65 Mail version 8.1.2 01/15/2001. Type ? for help.
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
66 "/var/mail/meillo": 1 message 1 new
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
67 >N 1 meillo@serveme.sc Wed Jul 14 22:50 13/467
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
68 & p
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
69 Message 1:
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
70 From <meillo@serveme.schnalke.local> Wed Jul 14 22:50:13 2010
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
71 Envelope-to: <meillo@serveme.schnalke.local>
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
72 To: meillo
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
73 From: <meillo@serveme.schnalke.local>
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
74 Date: Wed, 14 Jul 2010 22:50:13 +0200
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
75
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
76 some text
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
77
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
78 & d
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
79 & q
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
80
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
81
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
82 In case of problems
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
83 -------------------
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
84
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
85 Have a look at the log file: /var/log/masqmail/masqmail.log
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
86
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
87 Set the debug level in masqmail.conf, restart the daemon, redo the
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
88 test, and look at the debug file: /var/log/masqmail/debug.log
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
89
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
90 Ask on the mailing list: <masqmail@marmaro.de>
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
91
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
92
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
93
3dff59a4e764 added two setup guides
meillo@marmaro.de
parents:
diff changeset
94 meillo