1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/docs/simple-local-setup	Wed Jul 14 23:26:20 2010 +0200
     1.3 @@ -0,0 +1,94 @@
     1.4 +Simple Setup
     1.5 +============
     1.6 +
     1.7 +You want
     1.8 +--------
     1.9 +
    1.10 +- submit mail on stdin by calling masqmail on the commandline
    1.11 +- submit mail with SMTP from the local machine
    1.12 +- let masqmail deliver mail locally to the system mailboxes /var/mail/*
    1.13 +
    1.14 +You have luck, because this is what masqmail does by default.
    1.15 +
    1.16 +
    1.17 +Set up
    1.18 +------
    1.19 +
    1.20 +Follow the description in INSTALL.
    1.21 +
    1.22 +A common configure call would be:
    1.23 +
    1.24 +    ./configure --enable-auth --enable-ident
    1.25 +
    1.26 +
    1.27 +Configuration
    1.28 +-------------
    1.29 +
    1.30 +You just need a minimal config file, having one line:
    1.31 +
    1.32 +    host_name = "foo.example.org"
    1.33 +
    1.34 +(Substitute a real value, of course.)
    1.35 +
    1.36 +
    1.37 +Starting the daemon
    1.38 +-------------------
    1.39 +
    1.40 +Listening for SMTP connections on a port requires masqmail to run as
    1.41 +daemon. You probably want to start masqmail as daemon each time the
    1.42 +system comes up. How you have to do that is system dependent.
    1.43 +/etc/rc.local is a good try to add the daemon call, because this file
    1.44 +seems to be frequently available.
    1.45 +
    1.46 +    /usr/local/sbin/masqmail -bd -q10m
    1.47 +
    1.48 +This starts masqmail in daemon mode and does a queue run every ten
    1.49 +minutes.
    1.50 +
    1.51 +
    1.52 +Check the setup
    1.53 +---------------
    1.54 +
    1.55 +Ensure you have the sendmail links correct:
    1.56 +
    1.57 +    $ ls -l /usr/lib/sendmail /usr/sbin/sendmail
    1.58 +    lrwxrwxrwx 1 root root 25 2010-03-06 13:50 /usr/lib/sendmail -> /usr/local/sbin/masqmail*
    1.59 +    lrwxrwxrwx 1 root root 25 2010-03-06 13:50 /usr/sbin/sendmail -> /usr/local/sbin/masqmail*
    1.60 +
    1.61 +Send a mail to yourself:
    1.62 +
    1.63 +    $ echo "some text" | mail `whoami`
    1.64 +
    1.65 +Check if the mail was delivered (then delete it and quit):
    1.66 +
    1.67 +    $  mail
    1.68 +    Mail version 8.1.2 01/15/2001.  Type ? for help.
    1.69 +    "/var/mail/meillo": 1 message 1 new
    1.70 +    >N  1 meillo@serveme.sc  Wed Jul 14 22:50   13/467   
    1.71 +    & p
    1.72 +    Message 1:
    1.73 +    From <meillo@serveme.schnalke.local> Wed Jul 14 22:50:13 2010
    1.74 +    Envelope-to: <meillo@serveme.schnalke.local>
    1.75 +    To: meillo
    1.76 +    From: <meillo@serveme.schnalke.local>
    1.77 +    Date: Wed, 14 Jul 2010 22:50:13 +0200
    1.78 +    
    1.79 +    some text
    1.80 +    
    1.81 +    & d
    1.82 +    & q
    1.83 +
    1.84 +
    1.85 +In case of problems
    1.86 +-------------------
    1.87 +
    1.88 +Have a look at the log file: /var/log/masqmail/masqmail.log
    1.89 +
    1.90 +Set the debug level in masqmail.conf, restart the daemon, redo the
    1.91 +test, and look at the debug file: /var/log/masqmail/debug.log
    1.92 +
    1.93 +Ask on the mailing list: <masqmail@marmaro.de>
    1.94 +
    1.95 +
    1.96 +
    1.97 +meillo