Skip to content

Here's how to set up a locally-shared directory on a HylaFAX Enterprise server and to copy incoming faxes to it.

1) Install samba, if it isn't installed already

yum install samba samba-common

2) Create /smbshare (it doesn't have to be called that. This could be any name, anywhere on a file system where a mount point can live) and set it to be owned by the user "hylafax".

mkdir /smbshare chown hylafax /smbshare

3) Edit the Samba configuration in /etc/samba/smb.conf. Set a workgroup and server string (near the top of this file), as desired.

Near the bottom of the file are Share Definitions. Add an entry for the new directory to be shared, for example:

FAX share, added 6/15/2020

[smbshare] comment = Fax Share path = /smbshare browseable = yes guest ok = yes read only = no create mask = 0755 force user = hylafax force group = hylafax

4) Tell the system to start the samba service on boot

systemctl enable smb

5) Start the samba service

systemctl start smb

6) To verify things, at this point you can run

testparm

which shows the basic Samba configuration - and its service definitions should include the new share definition.

6a) Can't browse the share without auth? Set up a user for user-based authentication.

From the Linux command line, create a local userid and set a password to access those users:

useradd testuser passwd testpass

Then set the samba user and set a password for it, with "smbpasswd":

smbpasswd -a testuser

Then enable that userid, with the command:

smbpasswd -e testuser

7) Set up SELinux and Firewall

chcon -R -t samba_share_t /path/to/dir

Or if this is a home directory:

setsebool -P samba_enable_home_dirs on

firewall-cmd --add-service=samba --permanent

8) Configure FaxDispatch to copy incoming faxes to that share - OR - configure "Copy Path" in DID Routing/Sender Routing in the Web Interface.

8a) If you're using FaxDispatch, you can pretty much un-comment the example code to test this. If you've used a different name than "smbshare", you'll want to edit that name.

8b) If you're using the Web Interface, "Copy Path" is a field to specify a full directory path to where faxes for that DID/Sender should be copied.

9) Send yourself a fax and check that it's saved to the new share.