Upgrade Agent Client Collector manually on a macOS system

---
title: Upgrade Agent Client Collector manually on a macOS system
description: Perform a manual upgrade of your existing Agent Client Collector version on a system running a macOS. Manual upgrade is useful if the single-line command script isn’t connected to the instance or you want to use enhanced customization options.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/it-operations-management/agent-client-collector/acc-macos-upgrade-manual.html
release: brazil
product: Agent Client Collector
classification: agent-client-collector
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [ACC installation on a macOS system, ACC deployment - endpoints, Configuring Agent Client Collector, Agent Client Collector, IT Operations Management]
---

# Upgrade Agent Client Collector manually on a macOS system

Perform a manual upgrade of your existing Agent Client Collector version on a system running a macOS. Manual upgrade is useful if the single-line command script isn’t connected to the instance or you want to use enhanced customization options.

## Before you begin

-   The upgrade procedure is the same for both MID Server and MID-less deployments.
-   \(Optional\): Enable golden image mode for cloning additional agents by setting the golden image marker located at `/Library/Preferences/acc.rc.plist`.
-   Role required: agent\_client\_collector\_admin

## Procedure

1.  Manually back up the `agent-id` and `acc.yml` configuration files by running the following commands.

    ```
    mkdir -p /tmp/acc-upgrade-backup
    
    cp -rp /Library/Application\ Support/servicenow/agent-client-collector/acc.yml /tmp/acc-upgrade-backup
    
    cp -rp /Library/Application\ Support/servicenow/agent-client-collector/check-allow-list.json /tmp/acc-upgrade-backup
    
    cp -rp /Library/Application\ Support/servicenow/agent-client-collector/agent_now_id /tmp/acc-upgrade-backup
    
    ```

    Manually backing up the configuration files provides an added layer of security by ensuring that your files are backed up before beginning the upgrade process.

2.  Navigate to **All** > **Agent Client Collector** > **Deployment** > **Agent Downloads**.

3.  In the **macOS Downloads** section, download the relevant agent package and signature `.pkg` files.

4.  Perform package upgrade, based on the cpu your macOS runs with.

    -   Intel cpu:

        ```
        sudo installer -pkg agent-client-collector-<version number>-macos_x64.pkg
        ```

    -   Apple silicon cpu:
    ```
    sudo installer -pkg agent-client-collector-<version number>-macos_arm64.pkg
    ```

    This command also backs up and restores the agent-id and configuration files before upgrading.

5.  Verify that the upgrade was successful.

    1.  Navigate to **All** &gt; **Agent Client Collector** &gt; **Agents**.

    2.  Verify the following values for your agent:

        -   **Host data collection** = Collected
        -   **Version** = &lt;Relevant version number&gt;

**Parent Topic:**[Agent Client Collector installation on a macOS system](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-operations-management/agent-client-collector/acc-install-mac-os.md)