UiPath Assistant on Mac - Standalone 2023.10
Robot User Guide
Last updated Oct 31, 2023

UiPath Assistant on Mac

The UiPath Assistant is available on macOS and allows users to access, manage, or run cross-platform automations, and connect the Robot to Orchestrator.

Note: The UiPath Assistant is compatible with MacOS version 10.15 (Catalina) and newer.

For more details on the interface and sub-menus, see the Field Descriptions document.


The UiPath Assistant can be downloaded from the Customer Portal or from the Automation Cloud.

Download from the Customer Portal

  1. Go to the Customer Portal website.
  2. Search for your product and click the collapse icon on the right.
  3. Download the DMG file, based on your platform, the following options are available:
    • Download for Intel Macs - x64
    • Download for Apple Silicon

Download from the Automation Cloud

  1. Go to the Automation Cloud website.
  2. Click the Help icon on top of the page, and select Downloads from the dropdown menu.

  3. In the Featured Download section, choose one of the following options based on your platform:

    • Download for Intel Macs - x64
    • Download for Apple Silicon


To install the UiPath Assistant for macOS, follow the steps below:

  1. Double-click the DMG file to make its content available.
  2. Drag the application from the DMG window into the Applications directory to install it.
  3. Wait for the copy process to finish.

Connecting to Orchestrator

There are two ways of connecting the Robot and UiPath Assistant to Orchestrator:

Chrome Extension

When run on MacOS, processes that use web automations in browsers require the Google Chrome Extension to work.

When the Assistant is launched for the first time, if the extension is not detected, a prompt is displayed on the Assistant home page to install it. Additionally, you can add the extension from the UiPath extensions section of the Preferences menu in the Assistant.

Once the installation is complete, the browser must be restarted and the extension enabled manually.

Testing Processes on MacOS

When designing a process for MacOS in Studio, the testing is done using Remote Debugging and connecting to the specific MacOS machine.


UiPath Assistant logs are found in the combined.logs file from the /Users/john.doe/Library/Application Support/UiPath/ folder.

These logs contain all actions done by the user in the Assistant and any errors. Other specific Assistant files can be found in that folder as well.

Known Issues and Limitations

When using the Assistant on MacOS, the following features are not available:

  • Picture In Picture.
  • Sending Processes to desktop.
  • Task Capture Launcher.
  • RobotJS is not compatible with Safari browser.
  • The UiPath Diagnostic Tool is not available on MacOS machines. Instead, in Assistant, in the Troubleshoot section, certain log files are collected manually, which results in an archive used for debugging.

Updating the Orchestrator Connection

You can update the default Orchestrator service URL for Mac from the store.json (/Applications/UiPath Support/UiPath/store.json):

        "nextServiceUrl": "",
        "defaultServiceUrl": ""
        "nextServiceUrl": "",
        "defaultServiceUrl": ""

Opting Out of Telemetry

To disable the Telemetry in UiPath Assistant for Mac, add this in uipath.config file (you can find it in /Applications/UiPath

<add key="Telemetry.Enabled" value="false"/><add key="Telemetry.Enabled" value="false"/>
Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2023 UiPath. All rights reserved.