annotate docs/simple-local-setup @ 186:3dff59a4e764

added two setup guides they surely need improvements please help to improve them
author meillo@marmaro.de
date Wed, 14 Jul 2010 23:26:20 +0200 (2010-07-14)
parents
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