AsterFax the Email to Fax Gateway for Asterisk.
---------------   We have moved -----------------

AsterFax and Asterisk IT have both been renamed.

Asterfax is now known as Noojee Fax

Asterisk IT is now known as Noojee Telephony Solutions.

Noojee Fax documentation and support can now be obtained via:

---------------   We have moved -----------------
Asterisk IT is the primary developer and sponsor of AsterFax the Open Source Email to Fax Gateway for Asterisk.
Asterisk I.T. offer a range of support options for AsterFax as well as general Asterisk consulting services.  Contact for more information.
You can also receive support from the Asterfax and Asterisk communities by by posting at the relevant forum.

AsterFax - Asterisk Fax Logo

Running AsterFax

  1. Running AsterFax
      1. Stand alone
      2. Co-existing with Sendmail (and other mail servers)
      3. Running AsterFax as a Daemon

Stand alone

Generally you will want to run AsterFax as a daemon. You can however run AsterFax from the command line for testing purposes (and we do recommend this for initial testing).
Assuming that the Java 5 executable is on your path you can start AsterFax with the following command from /usr/lib/asterfax:

java -jar AsterFax.jar

alternatively you can run

To run asterfax in the background use:

To run asterfax as a daemon see the section Running AsterFax as a Daemon.

The above command needs to be run from the directory where the AsterFax jar (normally /usr/lib/asterfax) is located, otherwise it won't find the AsterFax.xml and the log4j.xml configuration files.

Co-existing with Sendmail (and other mail servers)

If you are running AsterFax's built in SMTP Gateway and have another SMTP server running on the same server as AsterFax then you may need to start AsterFax on an alternate IP address or Port (you still need to run AsterFax as a daemon). In this case you can start AsterFax as follows:

java -jar AsterFax <listen Host> <listen port>

where <listen Host> is the IP address for AsterFax to listen on and <listen port> is the port number for AsterFax to listen on. Generally we recommend that you run AsterFax on an alternate port as follows:
java -jar AsterFax 26
The above command will force AsterFax to listen on port 26 on all IP addresses.

Note: if you wish AsterFax to use port 25 in conjunction with another mail server you may also have to reconfigure your mail server to only listen on a specific IP address as most mail servers will by default listen on all available IP addresses.

If you receive a 'BindException' on start-up then AsterFax has a conflict with either another mail server or you have two instances of AsterFax running.

Running AsterFax as a Daemon

Regardless of the how you configure AsterFax (standalone or co-existing with sendmail) you will want to run AsterFax as a daemon.

A daemon process is a process which runs in the background and which is started automatically each time the system is booted.
The method you use to run AsterFax as a daemon will depend on the Linux Distribution.
For Redhat link the script into:

Red Hat and Red Hat-based distributions include an RPM, SYSVINIT, that includes a short bit of documentation named SYSVINITFILES. This document briefly explains the structure of such scripts.
Note: to install a scripts you need to place it in the right directory and run the CHKCONFIG utility to create the additional symlinks Red Hat requires.

Alternatively you can use inittab

Mainly for testing purposes you can also force AsterFax to run as a background task from the console by using:

of course when you next reboot AsterFax will NOT automatically be restarted.

You can also put an entry in ????

Once you have started AsterFax check the log file in logs/asterfax.log (under the asterfax install directory).

AsterFax UserGuide
Configuring Email Clients
Supported File Formats
Installing AsterFax
Configuring AsterFax
Testing AsterFax
Trouble Shooting AsterFax
Running AsterFax
Configuring SendMail
Configuring GhostScript
Configuring OpenOffice
Add your own File format

AsterFax is Sponsored by Asterisk I.T.
©2006  Asterisk I.T. all rights reserved. Some parts of this site may be the copyright of other authors. If you want to copy parts of this page you may do so provided you have gained permission from Asterisk I.T. first. Email
AsterFax™ is a trade mark of Asterisk I.T..
I'm not a great believer in Trade Marking Open Source software but unfortunately someone has been running a scam to redirect traffic to a bogus AsterFax web site. As such I've trade marked AsterFax's name to provide protection from such people.