@Mail POP3 Server configuration

1 Introduction: What is @Mail POP3

2 Configuring @Mail POP3 Server
    2.1 Running via Inetd
    2.2 Running via command line
    2.3 Relay Configuration
    2.4 Testing

3 Contact Information

1 Introduction: What is POP3?

@Mail POP3 allows your @Mail users access their eMail with a POP3 client like Eudora or Outlook. If you have configured @Mail to run as a Server with it's own users that can send / receive email.

If you wish to configure @Mail as a web interface to access other POP3 accounts, Please see @Mail POP3 Client Configuration

The @Mail POP3 server can be run in one of two ways; inetd or via the command line. We recommend that you run @Mail POP3 Server via Inetd

2 Configuring @Mail POP3 Server

Configuration the @Mail POP3 Server is done via the atmaildir/modules/pop3server/pop3.conf file.

$port = shift || 110;

If you are already running a POP3 Server on port 110 that you can not disable, you need to run @Mail on a different Port. You can set the port here. If you can not run port 110, change this to port 1100

$server = "\@Mail POP3 Server";

This is what people will see if they telnet into your POP3 Server.

$timeout = 1800;

The idle timeout in seconds before users must login again

$userid = "nobody"

This must the same username that @Mail is running as, If you are running @Mail via the web, this will be your web-server user.

$smtpauth = "/etc/mail/access";

Feature to add users IP address to a file, allowing users to relay via the SMTP server

2.1 How to install via inetd

Edit /etc/inetd.conf

If you are running an other POP3 server that you are not using, make sure that you comment it out.

#pop-3 stream tcp nowait root /usr/sbin/tcpd ipop3d -s -d

Add a line similar to:

pop-3 stream tcp nowait [atmailuser] [atmaildir]/modules/pop3server/pop3-inetd.pl pop3-inetd.pl

Where [atmailuser] is the username with permissions over @Mail and the Path [atmaildir] to @Mail is correct.

Note: Make sure that you are careful when configuring Inetd! If Inetd fails to restart you may not be able to access your server via Telnet / SSH / FTP or HTTP.

2.2 How to Install standalone server

The pop3.pl runs as a standalone daemon. This mode of operational is recommended.

root#: nohup perl pop3.pl [port optional] &

This will leave the process in the background, accepting connections for POP3 clients. Running it on STDOUT can be helpful to see incoming connections, you can also pipe the output to a file for logging purposes.

The POP3 daemon runs standard on port 110 , you may need to disable your current pop3 server in /etc/inetd.conf to free the port for @Mail

You can specify the server to listen on another port by specifying the port number on the first argument on the command line

Note: Make sure that you add this line to your startup script file so that the @Mail POP3 Server is started again if the server restarts.

2.3 Relay Configuration

When a user connects via the POP3 server their IP address can be appended to a file. The SMTP server can be configured to read this file for relay permissions.

To configure the POP3 server for Sendmail:

First edit the pop3.conf with the following:

$smtptype = "sendmail";

$smtpauth = "/etc/mail/access";

$makemap = "1";

Where /etc/mail/access is the location of your Sendmail access file (See the sendmail.cf for the exact pathname)

The permissions of the $smtpauth file must be owned by the user defined in the pop3.conf file.

To configure the POP3 server for Exim:

$smtptype = "exim";

$smtpauth = "/usr/exim/relay-access";

The permissions of the $smtpauth file must be owned by the user defined in the pop3.conf file.

2.4 Testing

To work with more than one domain, the domain must be given with the username.

Username: username#domain
Password: password

For additional domains, users must authenticate by user#host

root:# telnet domain.com 110
Trying 243.189.1.4...
Connected to main.
Escape character is '^]'.
+OK Welcome to @Mail POP3 Server. Authenticate yourself.
user ben#wapatmail.com
+OK Password required for ben@wapatmail.com
pass benben
+OK ben has 1 messages (2816 octets)
retr 1
+OK 2816 octets
Received: (netbased@localhost) by netbasedsoftware.com (8.9.2) id PAA32211;
Thu, 14 Sep 2000 15:42:51 GMT
Date: Thu, 14 Sep 2000 15:42:51 GMT
Message-Id: 200009141542.PAA32211@netbasedsoftware.com>
To: ben@wapatmail.com
X-Uidl: 968946171264
From: info@CGIsupport.com
Subject: Welcome Ben to your new account!
Content-Type: text/html;
X-Mailer: @Mail 3.1 (http://webbasedemail.net)

[themsg]
.
quit
+OK Goodbye (No msgs deleted)
Connection closed by foreign host

3 Contact Support

For additional support, please visit our web site, http://webbasedemail.com
Or send us an eMail : support@CalaCode.com