Deploy PDQ Detect Agent for Windows using SmartDeploy


SmartDeploy can be used to deploy the Windows OS as well as custom application packs. Below, you'll find instructions for how to create a custom Application Pack to deploy the PDQ Detect agent using SmartDeploy.


You may notice the names CODA and Footprint on this platform, and we may link to some CODA-specific documentation. CODA and PDQ Detect refer to the same platform. You know how it goes after companies combine forces - sometimes the branding takes a little while to settle down. If you have any questions, feel free to contact us.


SmartDeploy supports Windows 10/Windows Server 2016 or newer, and you may use SmartDeploy to deploy the PDQ Detect agent onto these endpoints.

If you wish to install the PDQ Detect Agent onto any older Windows endpoints (Windows 7+/Windows Server 2008 R2+) in order to catalog their inherent vulnerabilities as operating systems past their end-of-support, you may install the Detect Agent onto these endpoints manually.

Download the Detect Agent for Windows installer

  1. Log into the PDQ Detect Management Portal at
  2. On the left bar, click Scan Surface.
  3. On the top menu, click Agent-based Surface.
    • If Agent-based Surface does not appear here, you may need to enable this feature.
      1. Browse to Settings | Client Settings.
      2. Locate the Installation Mode, and select Enable Agent-based.
      3. Click Just enable the features.
      4. You can then return to Scan Surface and click Agent-based Surface.
  4. Switch to the Setup agents tab.
    • On the Use Detect Agents to gain more insights on your organization's internal security page, on the right side, you will see two important pieces of information which you will need to set up each endpoint:
      • 🌐Detect Agent Management URL:
      • 🔑Detect Agent Token (a unique alphanumeric token which your Internal Scanner VM will use to communicate with your PDQ Detect environment)
  5. Under the Windows logo, click Get | Download MSI Installer.
  6. Save the .msi file to a new, empty folder.

Create Application Pack to Deploy PDQ Detect

  1. In the SmartDeploy console, browse to Applications & Tasks and click the plus (+) icon in the top right corner, and then click Create an Application Pack.
  2. In the Application Pack Wizard, click past the Welcome page. 
  3. On the Installation Files page, click the first Browse button (for Folder Path), browse to the folder where you saved the .msi file above, and select this folder.
  4. Click the second Browse button (for Executable Path), and browse to the .msi file itself.
  5. On the Application Pack details page, note that properties of the MSI have been auto populated - any of these values can be edited if you wish.
  6. On the Installation Task page:
    • Enter the following Arguments, making sure to fill in the correct URL and Token as provided
      /L*V "C:\windows\temp\fp_install.txt" SERVER_URL="" TOKEN="112233445566aabbccddeeffgg"
    • Check the boxes for Quiet Installation and No Restart.
  7. The Installation Detection page will be auto populated with a GUID that represents this application. Click Next to continue.
  8. Save the Application Pack to the Application Packs folder in the SmartDeploy directory.
    This is C:\SmartDeploy\Application Packs by default. 
  9. In the SmartDeploy console, your newly created Application Pack should appear, and can now be used for deployment.
  10. See Deploy an Application Pack for detailed instructions.
  11. After you deploy the Application Pack and it has installed successfully onto an endpoint, you can view the deployed agent(s) in PDQ Detect under Scan Surface | Agent-based Surface | Deployed agents
Was this article helpful?
Still have a question or want to share what you have learned? Visit our Community Discord to get help and collaborate with others.