---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Install MID-less Agent Client Collector manually in a macOS environment

# Install MID-less Agent Client Collector manually in a macOS environment {#ariaid-title1}

* Release version: Xanadu
* 
* Updated July 20, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Install MID-less Agent Client Collector manually on a macOS machine to enable sending data from the agent to the instance through the cloud. Sending information through the cloud allows the MID Server to be used for more persistent resources.

## Before you begin

* Install the ITOM Cloud Services Core (sn_itom_cloud_svc) plugin.
* Onboard your instance to use ITOM Cloud Services. For details, contact Customer Support.
* Configure an agent registration key. For details, see [Configure an agent registration key](https://www.servicenow.com/docs/QcRD0~RdSE8Ap9liTeiwvg "Configure an agent registration key so that you can deploy Agent Client Collector by using ITOM Cloud Services. With ITOM Cloud Services, you can deploy Agent Client Collector without a MID Server, which saves the MID Server for more persistent resources.").
* Role required: agent_client_collector_admin
{#acc-install-ics-macos-manual__ul_whm_qmw_1gc}

## About this task

For details on sending data through the cloud in a MID-less deployment, see [DEX Architecture](https://www.servicenow.com/docs/access?context=dex-architecture&version=xanadu&pubname=xanadu-it-service-management&ft:locale=en-US).

## Procedure

1. Download the installation files to your local machine.  

       curl -L <download link from the Agent Downloads page on the instance>

2. Validate the installation file signature.  

       pkgutil --check-signature agent-client-collector-<version number>-macos-catalina_x64.pkg

   Note:  
   Ensure that the pkg certificate chain has the ServiceNow developer ID installer certificate.
3. Install the Agent Client Collector package.  

       sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /

4. Copy the installation files.
   1. Sample configuration file:  
      sudo cp -p /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml.example /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml
   2. Sample allow list file:  
      sudo cp -p /Library/Application\\ Support/servicenow/agent-client-collector/check-allow-list.json.default /Library/Application\\ Support/servicenow/agent-client-collector/check-allow-list.json
   {#acc-install-ics-macos-manual__substeps_yts_mnw_1gc}
5. **Optional:** To create new check definitions to be included in the allow list, first disable the allow list by commenting out the allow-list parameter in the acc.yml file.  
   sudo -H -u _servicenow vi /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml  
   Note:  
   This action compromises your system's security and is recommended only as a temporary measure until you finish updating the allow list. After completing the update, uncomment the allow list parameter in the configuration file to re-activate the allow list.

   For details on adding custom checks to an allow list, see [Generate an Agent Client Collector allow list](https://www.servicenow.com/docs/nYjQi7bL6gbwY635v6koWQ "Specify the checks to be included in the list of checks that are enabled to run on the agent.").
6. In the acc.yml configuration file:
   1. Set the following parameters:  
      {#acc-install-ics-macos-manual__table_q3f_24w_1gc__entry__2}

      | Parameter | Value |
      |-|-|
      | backend-url | "\<gateway URL\>" |
      | connect-without-mid | true |
      | instance-url | "\<instance URL\>" |
      | registration-key | "\<regsitration-key\>" |
      | insecure-skip-tls-verify | false |
      [ ]

      {#acc-install-ics-macos-manual__table_q3f_24w_1gc}
   2. Comment out the api-key parameter.
   {#acc-install-ics-macos-manual__substeps_wb3_ynw_1gc}
7. Save the configuration file.
8. To ensure that the configuration file points to a valid endpoint, run the following commands to restart the Agent Client Collector:  

       sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist
       sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist

   Note:  
   By default, exiting the installation program causes the program to restart immediately. To ensure that the program remains stopped after exiting, set the KeepAlive property in the /Library/LaunchDaemons/com.sn.acc.plist file to false.