+ </div>
+
+<hr width="100%" size="2">
+<h2 align="center"><a name="Configuring_Citadel_for_Internet_e-mail"></a>Configuring
+Citadel for Internet e-mail</h2>
+<div align="justify">
+<h3><a name="Introduction"></a>Introduction</h3>
+As you know by now, Citadel is a completely self-contained, full-featured
+Internet e-mail system. When you run Citadel you do not need any other
+mail software on your host system. This eliminates the need for tedious
+mucking about with sendmail, qmail, postfix, Cyrus, the UW IMAP server, or
+any of countless other needlessly complex programs that lead some people
+to the false assumption that Unix systems are difficult to administer.<br>
+<br>
+Some of the many features supported by Citadel are:<br>
+<ul>
+ <li>Built-in SMTP and ESMTP service, for delivering and receiving e-mail
+on the Internet</li>
+ <li>Built-in POP3 service, for remote fetching of messages</li>
+ <li>Built-in IMAP service, for access to mail using any standard mail client
+program</li>
+ <li>Web mail (implemented using the "WebCit" middleware, which is installed
+separately)</li>
+ <li>Support for mailing lists, in both "individual message" and "digest"
+formats</li>
+ <li>Multiple/virtual domain support</li>
+ <li>Any user may have multiple Internet e-mail addresses, in multiple domains</li>
+ <li>Global address book (Users with addresses in a domain may be spread
+out across many servers on a Citadel network)</li>
+ <li>Easy-to-configure integration with <a
+ href="http://www.spamassassin.org/">SpamAssassin</a> can block spam <i>before</i>
+it enters the mail system</li>
+</ul>
+This section of the documentation will demonstrate how to configure these
+features.<br>
+<br>
+<h3><a name="Basic_site_configuration"></a>Basic site configuration</h3>
+
+<P>Basic configuration of your Citadel system for Internet e-mail begins
+with the <tt><b>.A</b>ide <B>S</b>ystem configuration <B>I</b>nternet</tt>
+command:</p>
+
+<PRE>
+Lobby> <b>.A</b>ide <B>S</b>ystem configuration <B>I</b>nternet
+
+### Host or domain Record type
+--- -------------------------------------------------- --------------------
+ 1
+<A>dd <D>elete <S>ave <Q>uit ->
+</PRE>
+
+<P>This is a "clean" setup. For a simple, standalone e-mail system
+you simply have to enter the <TT><B>A</B>dd</TT> command:</p>
+
+<PRE>
+<A>dd <D>elete <S>ave <Q>uit -> <B>A</B>dd
+
+Enter host name: schmeep.splorph.com
+ (1) localhost (Alias for this computer)
+ (2) gateway domain (Domain for all Citadel systems)
+ (3) smart-host (Forward all outbound mail to this host)
+ (4) directory (Consult the Global Address Book)
+ (5) SpamAssassin (Address of SpamAssassin server)
+
+Which one [1]:
+</PRE>
+
+<p><b>localhost:</b> Basically what you're doing here is telling Citadel what
+any aliases for
+your machine are. If your machine were <tt>schmeep.splorph.com</tt> and you
+also had a DNS entry set up for <tt>blah.com</tt>, you might want to enter '1'
+and enter <tt>blah.com</tt> as your alias, so that e-mail sent to that
+address won't bounce.</p>
+
+<p><i>Important tip:</i> if your system is known by one name and <i>only</i>
+one domain, you might not even need to do this at all. You will recall that
+you entered your system's fully qualified domain name earlier when you went
+through the <tt><b>.A</b>ide <B>S</b>ystem configuration <b>G</b>eneral</tt>
+command. The domain name you entered there is automatically considered by
+Citadel to be a 'localhost' entry in your Internet mail configuration. It
+does not hurt to enter it in both locations, though.</p>
+
+<p><B>gateway domain:</b> this is a simple way of mapping various Citadel
+hosts in an Internet domain. For example, if you enter <tt>bar.com</tt>
+as a gateway domain, then mail to users at <tt>foo.bar.com</tt> will be
+forwarded to the host called <tt>foo</tt> on a Citadel network, mail to users
+at <tt>kunst.bar.com</tt> will be delivered to the Citadel server called
+<tt>kunst</tt>, etc. This feature has limited usefulness; if you are
+operating a network of Citadel servers, it is more likely that you will
+use the 'directory' feature, explained below.</p>
+
+<p><b>smart-host:</b> Normally, Citadel sends outbound Internet e-mail
+directly to its destination. This may not be appropriate for some sites; you
+may require (due to local convention, security policy, or whatever) that all
+outbound mail be sent to an SMTP relay or forwarder. To configure this
+functionality, simply enter the domain name or IP address of your relay as
+a 'smart-host' entry.</p>
+
+<p><b>directory:</b> a domain for which you are participating in directory
+services across any number of Citadel nodes. For example, if users who have
+addresses in the domain <tt>citadel.org</tt> are spread out across multiple
+Citadel servers on your network, then enter <tt>citadel.org</tt> as a
+'directory' entry. <i>For this to work, all Citadel servers participating
+in directory service <b>must</b> carry and share the <tt>Global Address
+Book></tt> room.</i></p>
+
+<p><b>spamassassin:</b> if you are running a
+<a href="http://www.spamassassin.org">SpamAssassin</a> service anywhere on
+your <b>local</b> network, enter its name or IP address as a 'spamassassin'
+entry. This may be (and, in fact, will usually be) <tt>127.0.0.1</tt> to
+specify that the service is running on the same host computer as the
+Citadel server.</p>
+
+<p>Please install SpamAssassin as per its own documentation. You will want
+to run SpamAssassin in client/server mode, where a <tt>spamd</tt> daemon is
+always running on your computer. Citadel does not utilize the <tt>spamc</tt>
+client; instead, it implements SpamAssassin's protocol on its own.</p>
+
+<p>Connecting to a SpamAssassin service across a wide area network is
+strongly discouraged. In order to determine whether an incoming e-mail is
+spam, Citadel must feed the <i>entire message</i> to the SpamAssassin
+service. Doing this over a wide area network would consume time and
+bandwidth, which would affect performance.</p>
+
+<p>Citadel invokes the SpamAssassin service when incoming messages are
+arriving via SMTP. Before a message is accepted, it is submitted to
+SpamAssassin. If SpamAssassin determines that the message is spam, the
+Citadel SMTP service <i>rejects the message,</i> causing a delivery failure
+on the sending host. This is superior to software which files away spam
+in a separate folder, because delivery failures will cause some spammers to
+assume the address is invalid and remove it from their mailing lists.</p>
+
+<p>Now select <tt><b>S</b>ave</tt> and you are just about ready for
+Internet e-mail.</p>
+
+<h3><a name="Enabling_the_Internet_mail_protocols"></a>Enabling the Internet
+mail protocols</h3>
+Do stuff here.<br>
+<br>
+<h3><a name="Hosting_an_Internet_mailing_list"></a>Hosting an Internet mailing
+list</h3>
+It's fun. Try it.<br>
+<br>
+<hr width="100%" size="2"><br>
+<br>
+</div>
+ <br>