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

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Install ACC on macOS

# Install ACC for DEX on macOS {#ariaid-title1}

Release version: Brazil  
Updated October 23, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read  
Install Agent Client Collector (ACC) on a macOS device so that DEX can collect performance data and identify issues.

## Before you begin

* The ITOM Cloud Services Core plugin (sn_itom_cloud_svc) must be installed.
* Your instance must be onboarded to use ITOM Cloud Services. For details, contact Customer Support.
* An agent registration key must be configured.
* The device must authenticate to ITOM Cloud Services, which uses mutual Transport Layer Security (mTLS) to authenticate devices.
* Outbound HTTPS traffic on TCP port 443 must be permitted from every device running an ACC agent to the designated ServiceNow cloud FQDNs or IP ranges.
* If device connectivity to the internet is routed through a proxy network, the proxy must be configured. For details, see [Configure ACC to use a proxy for all traffic](https://www.servicenow.com/docs/xhRO5JM9g84a7pq_r4yTeA "Configure the Agent Client Collector (ACC) to use a proxy for all traffic by setting environment variables.").
* The User \[sys_user\] table must be populated with the first name and last name of the user logged in to the device. The CI record in the production environment is then assigned to the correct user.
{#install-acc-for-dex-macos__prereq-ul-acc-install-macos}

For enterprise-wide deployments, contact your Jamf application administrator.

Role required: root

## Procedure

1. Retrieve the agent registration key:
   1. Navigate to AllAgent Client CollectorDeploymentAgent Registration Key.
   2. Select the relevant agent registration key.
   3. Copy the registration key value and store it in a place where you can easily retrieve it when needed.
   {#install-acc-for-dex-macos__substeps_ez4_j3q_wxb}
2. Retrieve the publicly accessible gateway URL, based on your location:  
   * AMER (Americas): itomcnc-prod-gateway-amer.sncapps.service-now.com:443
   * EMEA (Europe): itomcnc-prod-gateway-emea.sncapps.service-now.com:443
   * APAC (Asia Pacific): itomcnc-prod-gateway-apac.sncapps.service-now.com:443
   {#install-acc-for-dex-macos__ul_c12_zgw_3kc}
3. On the device where you're installing the Agent Client Collector, open a Terminal session and access the root folder.
4. Enter sudo -i and enter your device password.  
   Note:  
   You must have administrative privileges on the device to install the agent.
5. On the device where you're installing the Agent Client Collector, enter the following command:  

       CONNECT_WITHOUT_MID="true" ACC_CNC="<gateway_endpoint>" REGISTRATION_KEY="<registration_key>" INSTANCE_URL="https://<instance_url>" bash -c "$(curl -L https://<instance_url>/api/sn_agent/agents/install_agent)"

   The following table describes the parameter values in the command.
   {#install-acc-for-dex-macos__table_i4m_yjq_wxb__entry__2}

   | Parameter | Description |
   |-|-|
   | CONNECT_WITHOUT_MID | Specify <kbd class="ph userinput">true</kbd> to enable MID-less installation. If you don't specify a value, the regular MID Server WebSocket installation is invoked. |
   | ACC_CNC | Public gateway endpoint for Agent Client Collector that you can specify. |
   | REGISTRATION_KEY | Active and valid agent registration key for the agent to communicate with. |
   | INSTANCE_URL | ServiceNow instance that the agent is registering with. |
   | ACC_ALLOW_LIST | Optional ACC_ALLOW_LIST=0 string that you can add to disable the allow list. Default: The allow list is enabled. Note: When you disable the allow list, you compromise your system's security. This action is intended as a temporary measure while you're updating the allow list. After you complete the update, remove ACC_ALLOW_LIST=0 from the command line. |
   | ACC_VALIDATE_SIG | Optional ACC_VALIDATE_SIG=0 string that you can add to disable installer certification validation. Default: Validation is enabled. Note: Disable the certification validation only when you're using nonstandard signature validation tools. |
   [Table 1. Command-line parameter values]

   {#install-acc-for-dex-macos__table_i4m_yjq_wxb}
6. Configure the ServiceNow sudoers file.  
   For details on the procedure, see [Configure the ServiceNow sudoers file](https://www.servicenow.com/docs/KVqQNXSU2o2PPbAPap1Lng "Configure the ServiceNow sudoers file to grant the servicenow user the permissions to run specific commands with elevated privileges.").
7. Restart the Agent Client Collector service by unloading and loading the launch daemon.  

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

   Note:  
   Restart the service after any change to the acc.yml file or the sudoers file.
8. View the agent log to confirm that the installation completed.  

       tail -f /Library/Application\ Support/servicenow/agent-client-collector/log/acc.log

{#install-acc-for-dex-macos__steps_tq4_zvm_k3c}
**Related concepts**   

* [DEX architecture](https://www.servicenow.com/docs/3MXrX_mX8omJIEun7BmhJw "Digital End-User Experience (DEX) architecture describes the cloud-native services, endpoint agents, and data flows that connect end-user devices to your ServiceNow instance.")  
**Related tasks**   

* [Create an ACC registration key](https://www.servicenow.com/docs/6tA3pQ39D~DFsAcQNVW2PA "Set up an Agent Client Collector (ACC) by creating an agent registration key to identify and authenticate agents that are enabled to send data to the collector. The key helps promote the security and integrity of the data collected from the system.")
* [Verify that an Agent Client Collector agent is registered](https://www.servicenow.com/docs/Kt6YZb~JHfQrErAyqvr4Hw "Confirm that an Agent Client Collector (ACC) agent is registered with your ServiceNow instance and is collecting host data. Validate the installation on a single device before deploying to your entire environment.")
* [Uninstall the Agent Client Collector agent from a device](https://www.servicenow.com/docs/37OHxGZWlXFHZSL6L3XS6w "Remove the Agent Client Collector (ACC) agent from a device to clean up the device after testing or decommissioning, or to reinstall the agent with different configuration settings.")

*[\>]: and then