This document will help you configure your remote devices for use with your axMail-FAX suite system.


Software can be found in the axmail-plugins directory on ftp://n1uro.ampr.org/pub/hamradio/packet/ or at https://axmail.sf.net. You'll need these as they provide pop-before-smtp (for authentication remotely) and a modified version of Qpopper by Qualcomm (where last I knew KA9Q was working at). On debian or debian based systems you will also need to run "apt-get install libssl-dev".

What to do next, I have the software

Configuring pop-before-smtp

After you ftp the needed suite files open them up (insure the have the tag of "axmail" in their name) and cd into pop-before-smtp. Compile scripts have been provided. Simply run: ./make-for-axmail and it will compile and install the service for you. After that you need to add lines into your /etc/postfix/main.cf file so your postfix will read it:
Find the following areas:

smtpd_recipient_restrictions =  permit_mynetworks,
and add:
        check_client_access hash:/etc/postfix/pop-before-smtp,
also:
smtpd_client_restrictions =
and add:
        check_client_access hash:/etc/postfix/pop-before-smtp,
then issue "postfix reload".

Configuring pop services

Next go into the qpopper directory and run: ./make4axmail.sh You'll need to do a couple things after that completes. First, insure qpopper.conf is in your /etc directory. If not copy it over. This has a format specific for pop-before-smtp to read your logins. Next you need to configure your internet superserver (xinetd, inetd, etc) to listen for pop3 requests. I'll show you xinetd: in /etc/xinetd.d create a file called qpopper and inside insure it contains the following: service pop3 { disable = no socket_type = stream protocol = tcp user = root server = /usr/sbin/in.qpopper server_args = popper -S -f /etc/qpopper.conf wait = no instances = 20 } restart xinetd. You can test it by telnetting to your localhost 110. You should see the header: Trying 127.0.0.1... Connected to localhost. Escape character is '^]'. +OK Qpopper (version 4.1.0) at n1uro starting.

Configure your remote device

I use an andriod and for my mail client I use Aqua Mail. I've had issues with other mail hosts and the Samsung email client just going deaf. Aqua Mail Pro allows for more than 2 services... and it supports a LOT.
When you go to configure your client for mail services keep the following in mind:

1 - your mail host name for both pop and smtp is [prefix].ampr.org
2 - your login name is just your account you created within axMail...typically
    this is just your callsign.
3 - your password (only used for pop) is that which was requested by axMail
    when you initially made your account or if you're the sysop it's your
    ssh/console password.
Here's a couple of snapshots:
Pop3 config:

SMTP config:

Note: your login will be automatic based on pop-before-smtp so there's no need to reauthenticate on SMTP.

Test your config

Send yourself a mail message and you should be off to the races with your own mail server that you control on the amprnet and the global internet. If your client has a setting for SMTP to pop before smtp, insure you select that. This will pop your mail before attempting to send any you write so that you won't get a relay denied error.


Document by: Brian N1URO.
Back home.