Personal tools
HylaFAX The world's most advanced open source fax server

Handbook:Server Operation:Receiving Faxes

One of the most common customizations that is performed on HylaFAX installations is that of changing faxrcvd from the default. This is to be considered normal. Each business or fax user seems to have a unique way of getting information to its recipients as well as the manner of presentation. Faxes are no different.

Default faxrcvd Delivery

A default faxrcvd configuration from the HylaFAX installation will e-mail a notification of the received fax to FaxMaster. The notification will appear similar to this:

Date: Sat, 19 Aug 2000 23:02:08 -0600
From: The HylaFAX Receive Agent 
Subject: facsimile received from
recvq/fax00008.tif ( Sender: Remote Fax ID Pages: 1 Quality: Fine Page: ISO A4 Received: 2000:08:19 23:00:27 TimeToRecv: 0:20 SignalRate: 14400 bit/s DataFormat: 1-D MR ReceivedOn: ttySx CommID: c00000010 (

If etc/hosts.hfaxd and RecvFileMode are configured for your access, then you should be able to view or retrieve the fax image or the CommID file by following the listed ftp link.

Attached TIFF/PostScript/PDF Mail Delivery

By using this procedure, the default mail will be sent with the fax image attached to that notification mail.

Create the file etc/FaxDispatch (usually /var/spool/hylafax/etc/FaxDispatch) so that it contains the following lines:


Substitute pdf or ps for tif as you desire.

Note that because TIFF and PDF are binary file types, metamail, uuencode, or some other encoding program must be installed. In HylaFAX versions prior to 4.2.0 (HylaFAX 4.2.0 and later natively supports both uuencode and mimencode) if you do not use metamail's mimencode, also include a line like


in your etc/FaxDispatch file where bin/uuencode_it is an executable shell script of the form

uuencode -m $1 $1 | grep -E -v "^begin|^====$" 2>/dev/null

HylaFAX versions prior to 4.1.1 do not support the FILETYPE option in FaxDispatch, and so the attachments will always be Postscript. Users of HylaFAX versions prior to 4.1.1 (shame on you) may be interested in using the old faxrcvd-mail scripts by Noel Burton-Krahn. They can be found here. Note that these WILL NOT WORK as-is on HylaFAX versions 4.1.1 and newer.

Viewing Received Faxes

Common Windows Viewers

Note that in order to set a default program to "Open" a file by double-clicking it, appropriate file type configuration must be entered into Explorer/View/Folder Options.../File Types for that file extension.

Common Mac Viewers

Common *NIX Viewers

This page was last edited on 28 March 2007, at 17:08.

Powered by MediaWiki
Attribution-ShareAlike 2.5

Project hosted by iFAX Solutions