Zimbra and Hylafax integration

Posted byTruong Anh TuanPosted inHylaFax, Technical, Zimbra

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}
  2. Edit file /opt/zimbra/postfix/conf/transport, append this line:
    3. 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
  3. Edit file /opt/zimbra/postfix/conf/main.cf, append this line:
    4. 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.

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

    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.

  5. Then of course, restart the Zimbra MTA service with command (as zimbra user):
    6. 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.