Installing the PDQ Connect Agent

Downloading the PDQ Connect Agent Installer

From the Devices page, select Download agent installer at the bottom of the devices list.

Note: The Agent MSI is unique for each organization.

Download Installer.png

With any of the following installation methods, it's important to note that while the PDQ Connect Agent is self-updating we do still suggest periodically updating the installer source used in deployments by redownloading the agent from the PDQ Connect console.

Manual Installation

  • Double click the PDQ Connect Agent installer to launch the installation wizard.


  • Click Next and wait for the installer to run.


  • Click Finish to complete setup.


  • Once the PDQ Connect Agent has been installed, the new device will appear in the PDQ Connect Devices page.


Command Line Installation

The following command may be used to silently install the agent after modifying the installer path to that of your own:

msiexec.exe /i "\\UNCPath\PDQConnectAgent-X.X.X.msi" ALLUSERS=1 /qn /norestart /log output.log

Installing with PDQ Deploy

Note: This section applies to on-prem & VPN connected devices only. 

  • In PDQ Deploy, create a new package with an Install Step.


  • Select the PDQ Connect Agent installer for the Install File.


  • Keep all other fields with their default settings.


  • Deploy the package by right clicking the package and selecting Deploy Once from the context menu or attach the new package to a Schedule.


Installing Through Group Policy

Create the Group Policy Object (GPO)

  • Open Group Policy Management and browse down to the Organizational Unit (OU) that you want to deploy to
  • Right click the OU you want to use and click "Create a GPO in this domain, and Link it here..."
  • Give the GPO a name

Edit the GPO

  • Right click the GPO and select Edit
  • Browse to Computer Configuration > Policies > Software Settings > Software installation
  • Right click on Software installation and select New > Package
  • Browse to the PDQ Connect Agent .msi file from the UNC path that endpoints will have access to
  • Select Assigned as the deployment method and click OK


Preparing the PDQ Connect Agent for an Image

In order to include the PDQ Connect Agent in a device image, use the command below to install the PDQ Connect Agent on the machine you are creating your image from. This command will install the PDQ Connect Agent but will not start the service, preventing the device from registering. 

msiexec /i PDQConnectAgent-{version}.msi START=no /qn

The image will need to be created without ever starting the PDQConnectAgent service, and the service should be set to start automatically. This will allow any device that used the image you are creating to start the PDQConnectAgent service for the first time upon the first boot and register in PDQ Connect as a new device. 

Note: Rebooting the image machine with the PDQConnectAgent service set to start automatically will cause it to register with PDQ Connect, and will prevent any machines that use that image from properly registering. Because of this, it is recommended to install the PDQ Connect Agent using the command above after any necessary reboots have already been performed while creating the image. If a reboot must be performed on the machine you're creating the image with, after using the command to install the PDQ Connect Agent, set the PDQConnectAgent service to Disabled first so it will not start when the device boots back up. Before completing the image and after all required reboots have been performed, you will need to set the service back to start automatically. 

Still have a question or want to share what you have learned? Visit our Community to get help and collaborate with others.