Equisys technical notes

Technical guidance, explanations and fixes for our products

HOWTO: Automating a Zetafax client install.



ID: ZTN1034

This Zetafax technical note applies to:

  • Zetafax Version 5, 6, 7 and 8.


The Zetafax client install program WKSETUP may be run with a number of switches to silently install the Zetafax client program ZETAFAX.EXE. These switches may be incorporated in a batch file and rolled out with SMS or similar to further automate the installation.

More information

Instructions to install the Zetafax client from a command line.

  1. Copy %windir%\ZETAFAX.INI from the Zetafax server computer to the %windir% of the target system.
  2. Edit ZETAFAX.INI so that it only contains the [ZETAFAX] and [SERVER] sections. The directory names can be specified with drive letters or UNC path names, but should not contain any spaces.  The ServerArea: line is not used (so don't worry if this directory is not visible from the workstation).
  3. Launch a command prompt on the target system to run zfax\SYSTEM\WKSETUP with the /q and /s switches, where 'zfax' is the name of the directory where the Zetafax server files are installed.  This will automatically install the Zetafax client program using the directories specified in the [SERVER] section.


xcopy \\servername\sharepoint\ZETAFAX.INI %windir%
\\servername\ZFAX\SYSTEM\WKSETUP /Q /S

  The above batch file would be run on each target client machine.

Note - with Zetafax 6.01 and later, "/h" can be used as an alternative to "/q".  "/q" will display error messages for some errors, and is intended for occasions when a user is present (eg a logon script).  "/h" (for "hush") is totally silent, eg for large scale unattended rollouts.

Last updated: 18th October 2005 (BM/EB)

First Published: 12 January 2000 (GC/GW)


Recent news

It’s that time of year again. Directions EMEA is right around the corner. This year, it takes place at the Austria Center in Vienna, between 9-11 October. Traditionally, Directions NA would take ...

We are delighted to announce that the Zetadocs Delivery and Zetadocs Capture Extension for Business Central is now available on AppSource, the app store for Business Central. This is an ...