The Java Apache Mail Enterprise Server (a.k.a. James) is a 100% pure Java SMTP and POP3 Mail server and NNTP News server designed to be a complete and portable enterprise mail engine solution. James is based on currently available open protocols.

Apache James is released under the Apache Software License, Version 1.1.

More information about Apache James can be found at: http://james.apache.org/

The latest Apache James version can be downloaded from: http://james.apache.org/download.cgi

Setup mail client to communicate with James SMTP server

This guide describes how to setup an email client such as Mozilla Thunderbird to send and receive messages from the email accounts created during the James installation.

Thunderbird is a free, open-source and cross-platform mail client for most operating systems including, but not limited to, Windows, Linux and Macintosh.

Operating system used
Windows XP Home Edition Version 5.1 SP 2

Software prerequisites

  1. Append custom text to the bottom of message body.

    • Open C:\Tools\james-2.2.0\apps\james\SAR-INF\config.xml

    • Add the following lines:

      <processor name="transport">
         <mailet match="All" class="AddFooter">
      The information in this electronic mail message is private and
      confidential, and only intended for the addressee. Should you
      receive this message by mistake, you are hereby notified that
      any disclosure, reproduction, distribution or use of this
      message is strictly prohibited. Please inform the sender by
      reply transmission and delete the message without copying or
      opening it.

    • Restart James.

    • Any email message send from this mail server contains a footer.

      Mailet footer.

  2. Setup mailing list.

    • Open C:\Tools\james-2.2.0\apps\james\SAR-INF\config.xml

    • Add the following lines:

      <processor name="root">
         <mailet match="[email protected]"
         <mailet match="[email protected]" class="AvalonListserv">

         <mailet match="All" class="ToProcessor">
            <processor> transport </processor>


         <repository name="faq"
            <destination URL="file://var/lists/faq/" />

    • A mailing list called "faq" is setup.

      A user can sign in to this mailing list by sending an email to:

      Mailing list sign in.

      To be remove from this mailing list the user sends an email to:

      Mailing list sign off.

      If a user is on this mailing list and sends an email to [email protected] then all users on this list will receive this email.

      Send an email.

    • A directory C:\Tools\james-2.2.0\apps\james\var\lists\faq is created.
      This directory contains all users who have signed in for the faq mailing list.
      To actually see all users email address:

      • Type: telnet 4555

        Enter administrator username and password.

      • Type: user faq

      • Type: listusers