Deploy PDQ Detect Agent for Windows using PDQ Deploy


PDQ Deploy can be used to deploy applications to endpoints in your environment as custom packages. Below, you'll find instructions for how to create a custom package to deploy the PDQ Detect agent using PDQ Deploy.


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.

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 (the custom URL that you use to manage your PDQ Detect environment)
      • 🔑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 a custom package in PDQ Deploy

  1. Open the PDQ Deploy console.
  2. Click File | New Package.
  3. Enter a Name and Version for the package.
  4. In the left pane, click Steps, then under New Step, click Install.
  5. On the newly created step, next to Install File, click the ... button. Browse to the Detect Agent installer MSI you saved above, and click Open.
  6. In the Parameters field, enter the following, making sure to include the correct values for your Detect Management URL ( and Detect Agent Token.
    SERVER_URL="" TOKEN="112233445566aabbccddeeffgg"
  7. Click Save and close the package.

Deploy the package

  1. Open the PDQ Deploy Console. In the left pane, click to select the package you've created.
  2. In the top right corner, click Deploy | Deploy Once.
  3. Select one or more deployment targets, check to make sure that your credentials are valid, and then click Deploy Now.

    For more detailed deployment instructions and options in Deploy, see How It Works: PDQ Deploy.
  4. 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.