<?xml version='1.0' encoding="UTF-8"?>
<guide link="/projects/Ultimate_Email_System_How-To/ultimate-email-system-how-to.xml">
<title>IN PROGRESS:  Ultimate Email System How-To</title>
<author title="Web Programmer, Linux Enthusiast">Jacob Barde</author>
<abstract>The How-To entails the instructions and procedures to setup the
	ultimate email system.  It makes uses of the following technologies:
	Maildir/ formatted mailboxes, IMAP, SSL, Apache (+mod_ssl, +mod_php),
	SquirrelMail and/or Horde.org's IMP Mail, Cyrus-SASL, FetchMail,
	PostFix and Bayesian spam filters.
</abstract>
<version>1.0</version>
<date>07 Feb 2003</date>

<chapter>
<title>Pre-requisites</title>
<section>
	<title>Packages Needed</title>
	<body>
		<warn>This document is NOT FINISHED, and has not been tested.  The author takes no responsibility if you hose your system.</warn>
		<p>You will need the following packages:
			<ul>
				<li/>Apache (+mod_ssl &amp; mod_php)	- Web server including SSL (secure connections) and PHP
				<li/>Courier-Imap						- very nice IMAP server
				<li/>SquirrelMail						- a web-interfaced email client (you can use this, or your favorite web-interfaced email client, e.g. horde.org's IMP Mail)
				<li/>PostFix (?)						- an Mail Transport agent, not sure if needed with Courier-IMAP
				<li/>Evolution (or preferred email client)	- a desktop email client
				<li/>procmail (?, spambayes delivery)		- delivers email on the local system (Spambeyes can use it)
				<li/>FetchMail							- a nice program to go out and get all your email to store it on your local machine, very nice for consolidating your email
				<li/>Spambayes						- a Bayesian SPAM filter
				<li/>mb2md (mbox2Maildir) script			- a script to move mbox formatted email to the Maildir format which is easier to back up in an efficient manner.
				<li/>eudora2mbox script				- a script to migrate eudora email (similar-to-mbox format) to Unix mbox format
			</ul>
		</p>
		<p>On Gentoo systems:
			<pre>
<codenote>find a nice area to download and compile things</codenote>
# <i>cd /usr/local/src</i>
# <i>mkdir ultimate_emailsys</i>
# <i>cd ultimate_emailsys</i>
# <i>emerge sync</i>
# <i>emerge -u courier-imap squirrelmail postfix evolution procmail fetchmail apache php mod_php mod_ssl</i>
# <i>wget <uri>http://spambayes.sourceforge.net/download/spambayes-nightly.tar.gz</uri></i>
# <i>lynx <uri>http://batleth.sapienti-sat.org/projects/mb2md/</uri></i>
</pre>
		</p>
	</body>
</section>
</chapter>

<chapter>
<title>Setting up the server side of things</title>
<section>
	<title>Configuring Courier-IMAP</title>
	<body>
		<warn>This document is NOT FINISHED, and has not been tested.  The author takes no responsibility if you hose your system.</warn>
		
		<note>This follows the same guide as <uri link="">Gentoo's Desktop Configuration Guide</uri> section on Courier-IMAP.  See there for updates.</note>
		<warn>When I initially tried this, Courier-IMAP was being difficult with authenticating non-root users.</warn>
		<p>Anyway...</p>
	</body>
</section>

<section>
	<title>Configuring Apache</title>
	<body>
		<note>This follows the same guide as <uri link="">Gentoo's Desktop Configuration Guide</uri> section on Apache.  See there for updates.</note>
	</body>
</section>

<section>
	<title>Configuring SSL</title>
	<body>
		<note>This follows the same guide as <uri link="">Gentoo's Desktop Configuration Guide</uri> section on ____.  See there for updates.</note>
	</body>
</section>

<section>
	<title>Configuring mod_php</title>
	<body>
		<note>This follows the same guide as <uri link="">Gentoo's Desktop Configuration Guide</uri> section on ____.  See there for updates.</note>
	</body>
</section>

<section>
	<title>PostFix</title>
	<body>
		<note>This follows the same guide as <uri link="">Gentoo's Desktop Configuration Guide</uri> section on ____.  See there for updates.</note>
	</body>
</section>

<section>
	<title>procmail</title>
	<body>
	</body>
</section>

<section>
	<title>fetchmail</title>
	<body>
	</body>
</section>

<section>
	<title>SquirrelMail</title>
	<body>
		<note>This follows the same guide as <uri link="">Gentoo's Desktop Configuration Guide</uri> section on ____.  See there for updates.</note>
	</body>
</section>

<section>
	<title>Spambayes</title>
	<body>
	</body>
</section>

</chapter>

<chapter>
<title>Backing up your email</title>
<section>
	<title>Before backing up</title>
	<body>
		<warn>This document is NOT FINISHED, and has not been tested.  The author takes no responsibility if you hose your system.</warn>
		
		<warn>Do not restart any of these services until you have completed this entire How-To</warn>
		<warn>Stop fetchmail if you have it running, stop your MTA (sendmail, PostFix, qmail, etc.) any email client (Evolution, Outlook, Eudora, etc)</warn>
		Backup your email files on your server.  make sure to check <c>/var/spool/mail/[your username]</c>, <c>~/.mail</c>, <c>~/Mail/</c>, etc.
	</body>
</section>

</chapter>



</guide>
