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 firstname.lastname@example.org for more information.
You can also receive support from the Asterfax and Asterisk communities by by posting at the relevant forum.
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.
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 0.0.0.0 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.
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 asterfax.sh 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).
Configuring Email Clients
Supported File Formats
Trouble Shooting AsterFax
Add your own File format
AsterFax is Sponsored by
©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 email@example.com
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.