How can I deploy the MetaDefender Endpoint with Jamf Pro?
This article applies to all MetaDefender Endpoint releases deployed on macOS systems.
Jamf Pro is an IT administrative tool suite that offers automated and unified endpoint management for Apple devices.
The Jamf Pro server can be used to deploy various software and utility packages through networks of managed endpoints simultaneously and, as such, can also be used to deploy the MetaDefender Endpoint to your managed macOS endpoints.
To deploy MetaDefender Endpoint to your macOS endpoints using Jamf Pro, please follow the preparation and deployment instructions below.
Preparation
- Ensure that your Jamf Pro server is up and running.
- Ensure that all potential Client devices have the Jamf service running in the background.
Client side deployment
- First, you will need to save your account and group information to either the .GlobalPreferences file or the com.opswat.GearsClientConfiguration file. Whichever file you use, it must be stored by the Root user and opened by the Root user.
- Open a Terminal, type sudo su then enter the root password when prompted.
- Now, type cd /Library/Preferences and, once inside the folder, type the following:
- defaults write .GlobalPreferences OwcServerCode <server code here> to save your server code
- defaults write .GlobalPreferences OwcLicenseKey <license key here> to save your license key
- defaults write .GlobalPreferences OwcGroupId <group ID here> to save your group ID (optional)
- To delete a certain key (for example, if you no longer want to use the group ID you entered) please use the following command: defaults delete .GlobalPreferences <the key to be deleted>
- To test whether your values have been saved correctly, type: defaults read .GlobalPreferences
If you want to use the com.opswat.GearsClientConfiguration file instead of .GlobalPreferences to set up your information, please substitute the file name in the commands below.
The screenshot below illustrates the process, with the information being stored in the .GlobalPreferences file.

Jamf server side deployment
Ensure that all Client devices are connecting to the Jamf Pro server and, from the server side, follow the instructions below.
- Add the MetaDefender Endpoint package to the Jamf server. Read This to learn more. a. In your Jamf Pro dashboard, navigate to Settings: Computer Management>Package. b. Click the New button.
c. Click Choose File.
d. Choose the package file you wish to upload, in this case, the MetaDefender Endpoint package file.
e. Click Save, as illustrated in the screenshot below.

- Next, you must add the Start OPSWAT App script to the Jamf Pro server. Read This to learn more. a. In your Jamg Pro dashboard, navigate to Settings: Computer Management>Scripts. b. Click the New button.
c. Type the name of the script you wish to add, in this case, the name of the Start OPSWAT App script, as illustrated in the screenshot below.

d. Click on the Script tab.
e. Paste the script in the field provided, ensuring that the mode of the script is Shell/Bash, as illustrated in the screenshot below.

f. Now, click Save.
- Next, you must create a Policy to cover the rules for deployment of Client across your endpoints. Read This to learn more. a. Click on the Computer icon in the top right-hand corner of your Jamf Pro dashboard. b. Click on Policy, then click the New button.
c. Type a Display Name for the policy in the field provided, and set the Trigger as Start or Login.
d. Set the Scope to include the necessary Client devices.
e. In the Package tab, add the uploaded script and set its Priority as After.
f. Finally, click Save to apply your changes.
g. Logout or restart the Client devices to deploy the package.
The script is illustrated in the screenshot below.
Bash
loggedInUser=$(stat -f%Su /dev/console)
loggedInUserUID=$(/usr/bin/id -u "$loggedInUser")
•
/bin/launchctl asuser "$loggedInUserUID" launchctl unload -wF /Library/LaunchAgents/com.opswat.GearsApp.plist
/bin/launchctl asuser "$loggedInUserUID" launchctl unload -wF /Library/LaunchAgents/com.opswat.GearsAppRunOnLogin.plist
•
/bin/launchctl asuser "$loggedInUserUID" launchctl load -wFS Aqua /Library/LaunchAgents/com.opswat.GearsApp.plist
/bin/launchctl asuser "$loggedInUserUID" launchctl load -wFS Aqua /Library/LaunchAgents/com.opswat.GearsAppRunOnLogin.plist
•
fi
exit 0
If you have followed the instructions above but are having difficulty Deploying MetaDefender Endpoint Via Jamf Pro, please open a Support Case with the OPSWAT team via phone, online chat or form, or feel free to ask the community on our OPSWAT Expert Forum.