Index
Video Courses
Watch structured video courses
Knowledge Base
Visit our User Forum for discussions & solutions
XpressDox Agent
The XpressDox Agent is a lightweight application that runs locally on your computer and extends the capabilities of the XpressDox Web Application. Once installed, it acts as a local listener on port 52369, enabling the web application to interact directly with your desktop in the following ways:
- Open PDF files in your default desktop PDF application
- Open Microsoft Word files in editable mode
Without the Agent, documents opened from the XpressDox Web Application would open in read-only or browser-based mode. The Agent bridges the gap between the web application and your local desktop software.
Installation and Setup
Download the XpressDox Agent from the following link and run the installer:
Once installed, the XpressDox Agent will appear in your system tray. To confirm that it is running, double-click the XpressDox icon. A dialog will appear confirming that the Agent is active and showing the version number and the port it is listening on.
When you first visit the XpressDox Web Application after installing the Agent, your browser will display a prompt asking you to allow the web application to communicate with the Agent. You will need to accept this prompt for the Agent to function correctly.
For organisations looking to roll out the Agent across multiple machines, the preferred approach is to deploy it via a network policy, which allows for a centralised and consistent installation across all relevant devices.
Silent Installation of XpressDox Agent via msiexec
The XpressDox Agent can be deployed silently to end-user machines using the Windows Installer command-line tool msiexec. This is the recommended approach for system administrators deploying via tools like Intune, SCCM/MECM, Group Policy, or any RMM platform.
Command
|
Parameter |
Purpose |
|
|
Installs the specified MSI package |
|
|
Runs the installation with no user interface — the user sees nothing |
|
|
Suppresses any automatic reboot after installation |
|
|
Prevents the Agent from automatically updating itself — useful when the administrator wants to control which version is deployed |
Notes
- The command must be run with administrator privileges (e.g. from an elevated command prompt, or as SYSTEM via a deployment tool)
- If the MSI is not in the current working directory, provide the full path:
msiexec /i "C:\Installers\XpressdoxAgent.msi" /qn /norestart DISABLEAUTOUPDATE=TRUE - Paths containing spaces must be wrapped in double quotes
- To verify the result, check the exit code —
0means success,3010means success but a reboot is pending
Logging (Recommended)
To capture a log for troubleshooting failed deployments, append:
msiexec /i XpressdoxAgent.msi /qn /norestart DISABLEAUTOUPDATE=TRUE /l*v "C:\Logs\XpressdoxAgent_install.log"This writes a verbose log to the specified path, which is invaluable when diagnosing silent install failures.
Launching the Desktop Web Interview
The XpressDox Agent includes built-in desktop web interview functionality via the XpressDox Interview Runner, installed as part of the standard Agent installation.
Installation Location
C:\Program Files\XpressDox\XpressDox Agent\XpressDox.InterviewRunner
Usage
The Interview Runner is launched from the command line using the following syntax:
XpressDox.InterviewRunner.exe <Base_URL> [Template_Identifier]|
Parameter |
Required |
Description |
|
|
Yes |
The URL of your XpressDox server |
|
|
No |
The unique identifier (GUID) of the template to open |
Examples
Launch a specific template interview:
XpressDox.InterviewRunner.exe https://test.xpressdox.com/ dfbd9ea8-0ae3-4b2b-81f8-f7a9b1453ae9Launch the XpressDox Explorer (no template specified):
XpressDox.InterviewRunner.exe https://test.xpressdox.com/When no Template Identifier is provided, the XpressDox Explorer opens, allowing the user to browse and select a template manually.
Notes
- If the Interview Runner is not in your system
PATH, either navigate to the installation directory first or provide the full path to the executable - The Template Identifier is the GUID associated with the template, obtainable from the XpressDox server