view docs/simple-local-setup @ 421:f37384470855

Changed lockdir to /var/lock/masqmail; Create lockdir and piddir on startup. Moved the lockdir out of the spool dir. (When /var/lock is a ramdisk we do well to have the lock files there.) Added the new configure option --with-lockdir to change that location. Nontheless, if we run_as_user, then lock files are always stored in the spool dir directly. Instead of installing the lockdir and piddir at installation time, we create them on startup time now if they are missing. This is necessary if lockdir or piddir are a tmpfs.
author markus schnalke <meillo@marmaro.de>
date Wed, 30 May 2012 09:38:38 +0200
parents 5781ba87df95
children
line wrap: on
line source

Simple Setup
============

You want
--------

- submit mail on stdin by calling masqmail on the commandline
- submit mail with SMTP from the local machine
- let masqmail deliver mail locally to the system mailboxes /var/mail/*

You have luck, because this is what masqmail does by default.


Set up
------

Follow the description in INSTALL.

Most times it's simply:

    ./configure


Configuration
-------------

You just need a minimal config file, having one line:

    host_name = "foo.example.org"

(Substitute a real value, of course.)


Starting the daemon
-------------------

Listening for SMTP connections on a port requires masqmail to run as
daemon. You probably want to start masqmail as daemon each time the
system comes up. How you have to do that is system dependent.
/etc/rc.local is a good try to add the daemon call, because this file
seems to be frequently available.

    /usr/local/sbin/masqmail -bd -q10m

This starts masqmail in daemon mode and does a queue run every ten
minutes.


Check the setup
---------------

Ensure you have the sendmail links correct:

    $ ls -l /usr/lib/sendmail /usr/sbin/sendmail
    lrwxrwxrwx 1 root root 25 2010-03-06 13:50 /usr/lib/sendmail -> /usr/local/sbin/masqmail*
    lrwxrwxrwx 1 root root 25 2010-03-06 13:50 /usr/sbin/sendmail -> /usr/local/sbin/masqmail*

Send a mail to yourself:

    $ echo "some text" | mail `whoami`

Check if the mail was delivered (then delete it and quit):

    $  mail
    Mail version 8.1.2 01/15/2001.  Type ? for help.
    "/var/mail/meillo": 1 message 1 new
    >N  1 meillo@serveme.sc  Wed Jul 14 22:50   13/467   
    & p
    Message 1:
    From <meillo@serveme.schnalke.local> Wed Jul 14 22:50:13 2010
    Envelope-to: <meillo@serveme.schnalke.local>
    To: meillo
    From: <meillo@serveme.schnalke.local>
    Date: Wed, 14 Jul 2010 22:50:13 +0200
    
    some text
    
    & d
    & q


In case of problems
-------------------

Have a look at the log file: /var/log/masqmail/masqmail.log

Set the debug level in masqmail.conf, restart the daemon, redo the
test, and look at the debug file: /var/log/masqmail/debug.log

Ask on the mailing list: <masqmail@marmaro.de>



meillo