Deploy the Agent via Kandji

Deploy the ActivTrak Agent to macOS devices using Kandji blueprints. This guide walks you through creating a blueprint, configuring custom profiles (PPPC), and deploying the Agent.

Create a Blueprint

Create a Classic Blueprint for the machines where you want to deploy the Agent.

Configure custom profiles

1. Navigate to Library in Kandji
2. Create a custom profile for each configuration file:

• ATPPCv2.mobileconfig: Handles accessibility permissions
• disablebackgrounditemsnotification.mobileconfig: Suppresses installation pop-up messages

3. Upload each configuration file into the Profile section
4. Assign both profiles to your Blueprint

Verify PPPC installation

Important: Verify that both PPPCs have been installed on target devices before moving to the next step. Check the Profiles section to confirm that both profiles show as installed.

Create a custom application

Deploy the ActivTrak Agent as a custom application in Kandji.

1. Navigate to Library > Custom Apps > Add & Configure
2. Under Assignment, select Classic Blueprints and choose your blueprint
3. Under Settings > Installation, select Install once per device

Prepare the Agent file

Compress the ActivTrak Agent .pkg file into a ZIP file. Keep the original Agent filename—you'll need it for the post-install script

Upload and configure the Agent file

1. Navigate to the Custom App section
2. Go to Install Details and select ZIP File
3. Upload the ZIP file you created
4. Set the Unzip Location to /var/tmp/

Add the post-install script

Include the following post-installation script. Important: Edit lines 4 and 5 with the correct filename for your Agent .pkg file.

#!/bin/zsh
# unzip location is /var/tmp
# this is a post-install script
/usr/sbin/installer -pkg /var/tmp/"ATMacXXXXXX(8.4.3.0)_jumbleofstuff.pkg" -target /;
/bin/rm -Rf /var/tmp/"ATMacXXXXXX(8.4.3.0)_jumbleofstuff.pkg"
exit 0

Save and deploy

1. Review your configuration
2. Click Save to create the custom application
3. The Agent will deploy to devices in your blueprint as they check in with Kandji

Get help

If you have questions about this deployment process, contact support@ActivTrak.com for assistance.