--- title: "Deploying the OS X Agent JAMF Package" slug: "deploying-the-os-x-agent-jamf-package" updated: 2026-09-08T19:06:27Z published: 2026-09-08T19:06:27Z canonical: "docs.trellix.com/deploying-the-os-x-agent-jamf-package" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Deploying the OS X Agent JAMF Package After you create the JAMF package for the Endpoint Security (HX) software, you can deploy it to any OS X endpoints that have been enrolled in JAMF. Deploying the agent software involves setting up a policy in JAMF. This section describes how to set up this policy, create a script to start agent services on your endpoints, add the script to the deployment policy, and deploy the agent software to specific systems. ### Setting up a JAMF deployment policy JAMF deployment policies allow you to identify the OS X endpoints and host groups that should receive the policy and associate the agent JAMF package with a JAMF script and use the script to run the software on the assigned endpoints. To set up the policy and deploy the agent software to your Endpoint Security (HX) server host endpoints: 1. Open **JAMF Admin**. 2. Using JAMF Admin, upload the `.pkg` file you created and saved in [Building the package for deployment](/docs/capturing-and-installing-the-agent-jamf-package) by completing the following steps: 1. Drag and drop the `.pkg` file into JAMF Admin. 2. Assign the package to a category. 3. Select **File > Save** to save the file in your JAMF environment. ![Casper-2-1pkgupload.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-90de92fa-c657-f60d-13f6-62097cee1b50(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) 3. Log in to the **JAMF Web Console** and click on **Computers** and then **Policies**. 4. Click **New** to create a policy to push the package to your Endpoint Security (HX) server host endpoints that are managed by JAMF. ![Casper-2-2newpolicy.jpg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-f8e65c3a-8c20-2059-a0f1-b567d61df47e(1).jpg?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) 5. From the **Options** tab, select **General** and enter an appropriate display name in the Display Name field. 6. From the **Category Field** drop-down menu, select a JAMF category to add to the policy. ![Casper-2-3genoptions.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-4637b5e1-257c-a9a4-beae-687ebaaaa16f(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) 7. Under the **Trigger** section, select the trigger options that are required for your environment and deployment plan. For example, the agent software package is made available in Self Service later in these steps, so no trigger options are set in the screen below. ![Casper-1-8triggers.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-8a734e6f-7be8-b137-cfab-27d117c9341a(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) 8. From the **Options** tab, select **Packages** and add the package you uploaded in step 2 in the **Packages** pane on the right side of the screen. ![Casper-2-4pkgoptions.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-35357dfd-1506-5ca4-630a-13cbae23b66d(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) 9. Select the **Self Service** tab and select **Make the policy available in Self Service**. ![Casper-2-5selfsrvc.jpg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-2828c2f5-3a81-79df-5826-7aead922d697(1).jpg?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) 10. Click **Save**. ### Creating a script to start xAgent services After deploying the Endpoint Security (HX) software package to your OS X endpoints, you need to start the agent services on your Endpoint Security (HX) server endpoints. The JAMF Web Console allows you to create a script that will install the agent software package after the policy deploys the package to an endpoint and start agent services. 1. In the JAMF Web Console, click the **Gear button** (settings). 2. Click the **Computer Management** tab in the left pane and click the **Scripts** icon in the right pane ![Casper-2-6webconsole.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-caaca955-5737-352e-1254-31008545a146(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) 3. Create and name the new script. For example, the Display Name for the script shown below is *Start xAgent Service*. ![Casper-2-7newscript.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-cea5ab21-21cc-7ff4-80c4-c50ed7e407d3(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) 4. Select the **Script** tab and add the code below. Be sure to replace `xagtSetup_[xAgent version].mpkg` with the actual name of your .mpkg file. For example, `xagtSetup_[xAgent version].mpkg`). `#!/bin/sh` ` DIR1="/Library/Application Support/FireEye/" FILE1="xagtSetup_[xAgent version].mpkg" FILE2="agent_config.json" installer -pkg "$DIR1$FILE1" -target / sleep 30 rm "$DIR1$FILE1" rm "$DIR1$FILE2"` ![Casper-2-8scriptedits.jpg](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-c3cdc263-8d93-d53d-5319-fee623a6f648(1).jpg?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) 5. Click **Save**. ### Adding the script to the deployment policy This section describes how to add the script you created in [Creating a script to start xAgent services](/docs/deploying-the-os-x-agent-jamf-package#UUID-47662aeb-51b3-b930-216e-fa5747541a2f_id_creating) to the deployment policy you created in [Setting up a JAMF deployment policy.](/docs/deploying-the-os-x-agent-jamf-package#UUID-47662aeb-51b3-b930-216e-fa5747541a2f_id_setting) To add the script to your deployment policy: 1. Locate the policy you created in [Setting up a JAMF deployment policy](/docs/deploying-the-os-x-agent-jamf-package#UUID-47662aeb-51b3-b930-216e-fa5747541a2f_id_setting) step 4 and click **Edit**. 2. From the **Options** tab, select **Scripts** and add the script you created in [Creating a script to start xAgent services](/docs/deploying-the-os-x-agent-jamf-package#UUID-47662aeb-51b3-b930-216e-fa5747541a2f_id_creating) step 3 in the **Scripts** pane. 3. Select the **Scope** tab and click **Targets**. From the **Target Computer**s drop-down menu, add the OS X endpoints that you want to apply the policy to in **Self Service**. I ![Casper-2-10deploy.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-84c7e22b-a2b7-4d54-af99-660c727fac39(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) 4. From the **Target Users** drop-down menu, add the users or user groups that you want to apply the policy to in **Self Service**. 5. Click **Add** and **Save** to deploy the Endpoint Security (HX) software to your assigned endpoints and user groups. ### Installing the agent software on OS X endpoints Users with endpoints assigned the deployment policy can now install the Endpoint Security (HX) software and start agent services using the JAMF's Self Service tool. ### Note To completely automate the Endpoint Security (HX) software installation on the endpoint, set a trigger option for "Recurring Check-In" and remove the "Make Available in Self Service" condition from the deployment policy. To install Endpoint Security (HX) software on your endpoint: 1. Log into a host endpoint that has the deployment policy assigned. 2. Launch **JAMF's Self Service** tool. 3. Go to the JAMF category where the policy is located and click **Install**. ![Casper_SelfService_Install.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-adde0814-2d1c-6a93-0deb-15f737810f9a(1).png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A58%3A26Z&se=2026-11-22T14%3A58%3A26Z&sr=c&sp=r&sig=p8jTK9WE5H5eDBWhHl5%2BlHB9TO9rn3VkCzrv1ZTEF5w%3D) The agent software is now installed on that OS X endpoint. :