
 * Citadel and your Systems Mail Transport Agent

The easy way to get citadel doing inbound Mail is 
to install the "citadel-mta" package. 

You however can use your default MTA to deliver mails
to citadel using a feature called LMTP (Local Mail
Transport) which is supported by Postfix, Exim and 
qpsmp.

Citadel will open its lmtp Unix Domain Socket in 
/var/run/citadel/lmtp.socket
This is where you need to point your other MTA at.


 * Citadel and Exim

Exim is able to do this; however, the Author of this 
writing doesn't use it, and thus provides you just with 
this Link to the exim documentation:

http://exim.inode.at/exim-html-3.20/doc/html/spec_17.html

(If you know more, input is welcome)


 * Citadel and Postfix

Postfix offers more than just LMTP. Postfix also enables 
you to use DICT-TCP in order to verify whether an email
will be deliverable rigt after the other mailserver told
yours whom it wants to send mail to.
Have a look at this sample main.cf for postfix:

# appending .domain is the MUA's job. 
append_dot_mydomain = no 

# Uncomment the next line to generate "delayed mail" warnings 
#delay_warning_time = 4h
myhostname = sample.citadel.org 
mydestination = mail.sample.citadel.org, sample.citadel.org 
mynetworks = 127.0.0.0/8 
mailbox_size_limit = 0 
recipient_delimiter = + 
inet_interfaces = all
# ------------------------------------------------
# replace 127.0.0.1 with the ip of your citadel server, and 777 with
# the port you made it open its dict-tcp server
# in doubt check with netstat -lnp
# telnet ip port
# 
smtpd_recipient_restrictions =
	reject_non_fqdn_helo_hostname
	reject_unknown_sender_domain
        reject_non_fqdn_sender
        reject_unknown_sender_domain
	reject_non_fqdn_recipient
        reject_unknown_recipient_domain
	permit_mynetworks
        reject_unauth_destination
smtpd_data_restrictions =
        reject_unauth_pipelining
#if we deliver to citadel via lmtp, do it for example like that:
local_transport = lmtp:unix:/var/run/citadel/lmtp.socket
local_recipient_maps = tcp:127.0.0.1:777
# check the output of netstat -lnp for your lmtp.sock location.

More informations on this issue can be found at:
http://www.citadel.org/doku.php/faq:installation:configuring_postfix_to_validate_email_addresses_against_a_citadel_server


 -- Wilfried Goesgens <w.goesgens@outgesourced.org>, Thu, 17 May 2007 19:10:39 +0200
