Zimbra and Hylafax integration

You can setup Zimbra CS as a gateway for HylaFax users to send fax out using the scheme <fax number>@fax.our.domain, following these steps:

  1. Edit file /opt/zimbra/postfix/conf/master.cf, append this line:
  2. fax       unix  -       n       n       -       1       pipe
        flags= user=uucp argv=/usr/bin/faxmail -d -n ${user}
  3. Edit file /opt/zimbra/postfix/conf/transport, append this line:
  4. fax.your.domain   fax:localhost

    And then use this command to regenerate the transport.db file:

    /opt/zimbra/postfix/sbin/postmap /opt/zimbra/postfix/conf/transport
  5. Edit file /opt/zimbra/postfix/conf/main.cf, append this line:
  6. fax_destination_recipient_limit = 1

    Note: the process limit of 1 in the master.cf file is necessary with fax software that cannot handle multiple requests at the same time.

  7. Edit file /opt/zimbra/conf/localconfig.xml, modify the entry “postfix_transport_maps” as follow:
  8. <key name="postfix_transport_maps">
        <value>proxy:ldap:/opt/zimbra/conf/ldap-transport.cf, hash:/opt/zimbra/postfix/conf/transport</value>

    Note: specify dbm instead of hash if your system uses dbm files instead of db files. To find out what map types Postfix supports, use the command postconf -m.

  9. Then of course, restart the Zimbra MTA service with command (as zimbra user):
  10. zmmtactl stop
    zmmtactl start

Note: be sure to not advertise fax.your.domain in the DNS 🙂

This process has been tested on Zimbra CS Open Source edition 5.0.9 and HylaFax 4.4.4 running on the same Linux CentOS 5 machine.