meillo@186: Simple Setup
meillo@186: ============
meillo@186: 
meillo@186: You want
meillo@186: --------
meillo@186: 
meillo@186: - submit mail on stdin by calling masqmail on the commandline
meillo@186: - submit mail with SMTP from the local machine
meillo@186: - let masqmail deliver mail locally to the system mailboxes /var/mail/*
meillo@186: 
meillo@186: You have luck, because this is what masqmail does by default.
meillo@186: 
meillo@186: 
meillo@186: Set up
meillo@186: ------
meillo@186: 
meillo@186: Follow the description in INSTALL.
meillo@186: 
meillo@378: Most times it's simply:
meillo@186: 
meillo@378:     ./configure
meillo@186: 
meillo@186: 
meillo@186: Configuration
meillo@186: -------------
meillo@186: 
meillo@186: You just need a minimal config file, having one line:
meillo@186: 
meillo@186:     host_name = "foo.example.org"
meillo@186: 
meillo@186: (Substitute a real value, of course.)
meillo@186: 
meillo@186: 
meillo@186: Starting the daemon
meillo@186: -------------------
meillo@186: 
meillo@186: Listening for SMTP connections on a port requires masqmail to run as
meillo@186: daemon. You probably want to start masqmail as daemon each time the
meillo@186: system comes up. How you have to do that is system dependent.
meillo@186: /etc/rc.local is a good try to add the daemon call, because this file
meillo@186: seems to be frequently available.
meillo@186: 
meillo@186:     /usr/local/sbin/masqmail -bd -q10m
meillo@186: 
meillo@186: This starts masqmail in daemon mode and does a queue run every ten
meillo@186: minutes.
meillo@186: 
meillo@186: 
meillo@186: Check the setup
meillo@186: ---------------
meillo@186: 
meillo@186: Ensure you have the sendmail links correct:
meillo@186: 
meillo@186:     $ ls -l /usr/lib/sendmail /usr/sbin/sendmail
meillo@186:     lrwxrwxrwx 1 root root 25 2010-03-06 13:50 /usr/lib/sendmail -> /usr/local/sbin/masqmail*
meillo@186:     lrwxrwxrwx 1 root root 25 2010-03-06 13:50 /usr/sbin/sendmail -> /usr/local/sbin/masqmail*
meillo@186: 
meillo@186: Send a mail to yourself:
meillo@186: 
meillo@186:     $ echo "some text" | mail `whoami`
meillo@186: 
meillo@186: Check if the mail was delivered (then delete it and quit):
meillo@186: 
meillo@186:     $  mail
meillo@186:     Mail version 8.1.2 01/15/2001.  Type ? for help.
meillo@186:     "/var/mail/meillo": 1 message 1 new
meillo@186:     >N  1 meillo@serveme.sc  Wed Jul 14 22:50   13/467   
meillo@186:     & p
meillo@186:     Message 1:
meillo@186:     From <meillo@serveme.schnalke.local> Wed Jul 14 22:50:13 2010
meillo@186:     Envelope-to: <meillo@serveme.schnalke.local>
meillo@186:     To: meillo
meillo@186:     From: <meillo@serveme.schnalke.local>
meillo@186:     Date: Wed, 14 Jul 2010 22:50:13 +0200
meillo@186:     
meillo@186:     some text
meillo@186:     
meillo@186:     & d
meillo@186:     & q
meillo@186: 
meillo@186: 
meillo@186: In case of problems
meillo@186: -------------------
meillo@186: 
meillo@186: Have a look at the log file: /var/log/masqmail/masqmail.log
meillo@186: 
meillo@186: Set the debug level in masqmail.conf, restart the daemon, redo the
meillo@186: test, and look at the debug file: /var/log/masqmail/debug.log
meillo@186: 
meillo@186: Ask on the mailing list: <masqmail@marmaro.de>
meillo@186: 
meillo@186: 
meillo@186: 
meillo@186: meillo