--------------- 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 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.
If you are running trixbox or a CentOS/RedHat system you can just download the install script and run it. The script will do everything needed to get AsterFax up and running.
Download the script from to a convenient working directory and run it.
The install script is yum based and some of the AsterFax dependencies are available only from the trixbox yum repository. The install script will ensure that the trixbox repository is configured for yum before it starts installing the software.
A configure script is also been made available to make configuration less laborious. Download the configure.sh from and save it to the same location as the install script. When the installer is done it will prompt whether you want to configure the system. Answer 'y' and the confugre script is executed. Of course you can run the configure script directly. Beware that the script overwrites any existing configuration entries. We are working on a web based UI for configuration and general management of AsterFax.
Download the RPM then run 'rpm2cpio filename | cpio -i --make-directories' to extract it.
Help forum and someone will give you a hand.
Before installing AsterFax you need to install and configure a number of systems which AsterFax is dependant on.
Note: AsterFax must be installed on the same computer as Asterisk.
1. Install trixbox
2. Install Java 5
3. Install Ghostscript
e.g. yum -y install ghostscript4. Install X11
Note: we recommend at least ghostscript 8.x or later as earlier versions don't seem to render some PDF files correctly.
e.g. yum -y install Xvfb5. Install OpenOffice 2.0
e.g. yum -y install openoffice.org
[as of the time of this writting the above yum command will install openoffice 1.1. This is however adequate for AsterFax's purposes]6. Install AsterFax - Version 1 RC 1 RPM
run rpm -i asterfax-1.0-rc1.i386.rpm
The RPM installs the software to /usr/lib/asterfax by default.
AsterFax uses file system directories to queue and archive faxes.7. Install AsterFax - Non-RPM install
While the system ships with a reasonable default configuration we do not presume that the default will suit every environment.
For this reason at this stage the installation procedure does not create the required working directories.
Default directories that should be created are /var/log/asterfax and /var/spool/asterfax unless you change the configuration to use other directories.
Ensure that AsterFax will have full privileges to these directories at runtime.
Future installs might prompt for correct configuration and adjust accordingly.
unzip AsterFax-1.x-xxxx.zip to /usr/lib/asterfax
edit config/AsterFax.xml, update the Username/Password used to connect to Asterisk8. Copy AsterFax.xba into the OpenOffice /usr/lib/ooo-1.1/share/basic/Tools (or equivalent of OOo 2.0)
9. Edit the scripts.xba as documented here
10. Patch txfax by running /usr/lib/asterfax/modules/install.sh
11. Restart Asterisk
12. run ./asterfax.sh from /usr/lib/asterfax
AsterFax is now running using its own SMTP Server.
There are lots more configuration options if you are interested in using other AsterFax features then have a read of the configuring AsterFax page.
You can now send a fax by configuring your email client to use AsterFax as an alternate SMTP Server.
For details on configuring your email client look here.
Of course you can also read the page on configuring AsterFax to work with any existing mail server for a zero client configation option. This is our recommended configuration.
1. Trixbox (Recommended)Install trixbox which has the spandsp fax capabilities built in.
Trixbox provides a complete and simple installation onto a clean machine or optionally onto a machine which already runs Linux.
Trixbox provides all of the functionallity of Asterisk as well as a reasonable Web Interface for managing Asterisk.
For details on installing and download trixbox visit the trixbox web site: http://www.trixbox.org
2. Asterisk with spandspIf you are running trixbox then you don't need to worry about spandsp as it is included in trixbox, if you are running a straight Asterisk install then read on.
This is the more complicated option as it requires you to compile a custom version of Asterisk as Asterisk 1.2 does not include SpanDSP.
You can build a custom version of Asterisk which includes fax capabilities by undertaking the following instructions:
You can download Asterisk from here . We recommend Asterisk 1.2
Build and Installation instructions to include spandsp fax support can be found here:
If you only every want to fax Tiff files (unlikely) then you don't need to install Ghostscript. For everybody else you will need to install ostscript.
Note: ghostscript can be replaced by any other tool which is capable of converting a PDF file into a Tiff file. You will however have to modify the PDF Converter to utilize the alternate tool. For details look here.
The simplest way to get Ghostscript is to use apt-get or yum (or what ever the appropriate installer is for your version of Linux) to automate the install.
apt-get update && apt-get install ghostscript
or yum -y install ghostscript
Trixbox runs under Centos. Currently (as of Jan 2006) Centos only supports Ghostscript 7.70.
Some users have reported problems with ghostscript 7.70 not rendering PDF files correctly.
To over come this problem you can upgrade to the latest version of Ghostscript.
For details on how to do this read more here.
You can check out the list of supported file formats to see which formats require OpenOffice to be installed. Probably the most important file format MS-Word requires OpenOffice, so most installations will require OpenOffice as part of their installation.
AsterFax requires OpenOffice v1.1 or later, we however recommend v2.0.
You can download the latest version of OpenOffice from here .
For details on installing OpenOffice look here.
The log4j.xml file that ships with AsterFax contains configuration information pertaining to how and where AsterFax logs a variety of information. The default configuration will log messages to logs/asterfax.log and to the console. Unless you are having problems or want to tweak the way logging is performed you can generally ignore the log4j.xml file.
sendmail/postfix/Exchange Server via procmail. If you still wish to uses AsterFax's SMTP Gateway then read on.
Currently (as of beta 5) AsterFax will accept an email message from anyone. Whilst AsterFax is not an open relay, as it will never forward an SMTP message, it will send a fax on anyone's behalf. As such it should not be exposed to the outside world. (Unless you are happy for people to rack up large phone bills by sending faxes via your AsterFax gateway).
Note: providing a security model is high on my priority list. If you have any thoughts on how this should be implemented I would be happy to hear.
If you are using procmail to pull messages destined for AsterFax out of the normal mail processing pipeline of products such as sendmail then you don't need to worry about MX records. If you are running multiple SMTP servers then life does get more interesting and you are likely to need an MX record. In which case read on.
Any MX record for your AsterFax gateway should only be visible on your internal network as AsterFax will send a fax no matter who asks it to.
Depending on your requirements you can either configure an MX record for the AsterFax domain (normally fax.local) or create a subdomain such as fax.mydomain.com.
If you can, configure your email client to connect directly to the AsterFax SMTP gateway, which is generally the recommend methods for application developers who want to send a fax directly from their application (and for testing an AsterFax configuration) then no MX record is required.
If this sounds too complicated then I strongly recommend that you consult a DNS expert, as stuffing up your DNS server can have all sorts of consequences!
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.