Personal tools
     DOCUMENTATION

Appliance:Port25 Appliance

From rPath Wiki

Jump to: navigation, search

Contents

float
The Port25 Appliance brings the best open source mail tools into one easily-deployable form factor. Whether your mail protocol of choice is SMTP(S), IMAP(S), or POP3(S), Port25 can deliver. In addition, Port25 includes mail filtering, anti-virus protection, and spam filtering capabilities. The goal is to make a mail appliance that is secure, manageable, scalable, fast, reliable, and that provide the best spam and virus protection available from Open Source Software.



Port25 contains the following Open Source Software:

  • Postfix SMTP Server
  • Dovecot (default), Cyrus (experimental) -OR- Courier IMAP/POP3 Server (experimental)
  • Procmail (default) -OR- Cyrus SIEVE (only with Cyrus IMAP) Filtering Software
  • ClamAV Anti-Virus (alpha)
  • SpamAssassin

Download

Download page on rBuilder Online.

Installation

The fastest way to get started is to download one of the virtual appliance images and boot it. Alternatively, you can download the ISO images and complete the graphical installation to install Port25 on a dedicated system.

Image:Bulbgraph.png   For more information on using rPath-based appliances with various virtual machine technologies, refer to Using rBuilder Images with Virtual Machines.

Configuration

Login as root. No password is required for Virtual Appliances; for CD installs, use the password created during installation.

Mail Server Setup

Postfix Configuration

  • Use vi to edit /etc/postfix/main.cf to add the domain for which you are accepting email
    • Set myhostname if 'hostname' is not populated via your DHCP server.
    • Set mydestination (if necessary) to the domains for which your server is the final destination.
    • Further configuration may be necessary to handle spam and virus filtering.
    • Refer to the Postfix Documentation if you wish to make further configuration changes.
    • Reload your postfix configuration by typing postfix reload from the command line.

Dovecot Configuration

  • Use vi to edit /etc/dovecot.conf
    • Set the protocols to serve (default is imap/imaps)
    • For further configuration options consult the Dovecot Documentation
  • Set dovecot to start on boot by typing chkconfig dovecot on from the command line
  • Start dovecot by typing service dovecot start at the command line

Procmail Configuration

  • Use vi to add the following line to /etc/postfix/main.cf 
 mailbox_command=/usr/bin/procmail
  • Create a /etc/procmailrc file with default rules for your system. Leaving this file blank is fine too.

At this point you can start adding users and sending and receiving mail. An MX record in your DNS server may be necessary to enable remote servers to find your server. Verify that your configuration is correct before continuing.

Optional Configuration

You can set up spam and virus configurations as needed (Please feel free to contribute text to this section)

Image:Bulbgraph.png   ClamAV has not been well tested.

SpamAssassin Configuration

SpamAssassin can be configured in the default setup (dovecot, postfix, procmail) by editing /etc/procmailrc. The following example indicates one possible way of configuring SpamAssassin: 

#Add spamfiltering
:0fw
#Only filter messages smaller than a threshold
* < 150000
    | /usr/bin/spamc -f

:0:
* ^X-Spam-Status: Yes
mail/Spam

After doing so, all mail smaller than your threshold will be passed through spamc to spamassassin. You must issue the commands chkconfig spamd on and service spamd start to start the SpamAssassin daemon and ensure that it will run on reboot. Refer to the INSTALL file in /usr/share/doc/perl-Mail-SpamAssassin-3.1.3/README for additional details.

DSPAM Configuration

A experimental trove for DSPAM is available from the Port25 repository. If you are interested in improving DSPAM, please send a note to the Port25 discussion list.

SSL Certificate Configuration

The bundled SSL certificate for dovecot is setup for localhost.localdomain, this will probably not match the hostname of your actual server so you will want to update this or your e-mail client will complain about the hostname mismatch. To make this change edit /usr/share/doc/dovecot*/dovecot-openssl.conf then rm /etc/ssl/certs/dovecot.pem and /etc/ssl/private/dovecot.pem then run /usr/share/doc/dovecot*/mkcert.sh.

Support

Port25 is a community supported project. Questions about Port25 should be raised on the Port25 discussion list. You may also ask questions on #conary on irc.freenode.org.

Developers

The label for Port25 is port25.rpath.org@rpl:devel but it is compatible with rPath Linux 1 (conary.rpath.com@rpl:1).

Eventually, you'll be able to point a Port25 server at your LDAP user directory and add a NAS point for users' mail directories, and it will just work. Currently however, you must configure the resulting system manually.

If you are interested in contributing to Port25, subscribe to the mailing lists and use the Join Request Form to request project access. You are also welcome to contribute to the content of this page.

Retrieved from "http://wiki.rpath.com/wiki/Appliance:Port25_Appliance"