Skip to content

PDQ Deploy Integration

Deploy and manage SentriKat agents across Windows networks using PDQ Deploy.

Prerequisites

  • PDQ Deploy (Free or Pro)
  • SentriKat Windows Agent MSI installer
  • An API key with agent permissions
  • Network access from target machines to your SentriKat instance

Setup

Step 1: Download the Agent MSI

  1. Log into your SentriKat instance
  2. Go to Admin > Agents > Downloads
  3. Download the Windows Agent MSI
  4. Place the MSI on a network share or in your PDQ Deploy repository

Step 2: Create a PDQ Package

  1. Open PDQ Deploy
  2. Click New Package
  3. Add an Install step:
  4. Install File: Browse to sentrikat-agent.msi
  5. Parameters: 
    /quiet /norestart SERVER_URL="https://sentrikat.example.com" API_KEY="sk_agent_xxxxxxxxxxxx" ORG_ID="1"
  6. (Optional) Add a PowerShell step for post-install verification: 
    $service = Get-Service SentriKatAgent -ErrorAction SilentlyContinue
if ($service.Status -ne 'Running') {
    throw "SentriKat Agent service not running"
}
  7. Save the package

Step 3: Deploy

  1. Select the package
  2. Click Deploy Once or create a Schedule
  3. Choose target computers (Active Directory OU, PDQ Inventory collection, or manual list)
  4. Click Deploy

Configuration Options

Pass configuration as MSI properties:

Property Description Required
SERVER_URL Your SentriKat instance URL Yes
API_KEY Agent API key Yes
ORG_ID Organization ID No
SCAN_INTERVAL Seconds between scans (default: 86400) No
VERIFY_SSL Validate SSL certificate (default: true) No

Scheduled Deployments

For automatic deployment to new machines:

  1. In PDQ Deploy, go to Schedules
  2. Create a new schedule
  3. Set trigger to Heartbeat (deploys when new machines appear)
  4. Target a PDQ Inventory Collection (e.g., "Machines Without SentriKat Agent")
  5. Assign your SentriKat package

Create PDQ Inventory Collection

Filter machines that do not have the agent:

  1. In PDQ Inventory, go to Collections
  2. Create a Dynamic Collection
  3. Add filter: Applications > Name > Does Not Contain > SentriKat Agent
  4. Save

Upgrading Agents

  1. Download the new MSI version
  2. Update the PDQ package with the new MSI file
  3. Deploy to all machines — the MSI handles upgrades automatically
  4. Verify in SentriKat under Admin > Assets that agent versions updated

Uninstalling

Create a separate PDQ package for removal:

  1. New Package > Uninstall step
  2. Set the MSI product code or use: 
    msiexec /x {PRODUCT-GUID} /quiet /norestart
  3. Deploy to target machines

Troubleshooting

Deployment Fails with Access Denied

  • Ensure PDQ Deploy runs as a domain account with local admin rights on targets
  • Verify Windows Firewall allows File and Printer Sharing and WMI

Agent Installed but Not Reporting

  • Check that target machines can reach your SentriKat URL on port 443
  • Verify the API key is valid in Integrations > Agent Keys
  • Check agent logs: C:\ProgramData\SentriKat\agent.log

Next Steps