robot
2023.10
false
Robot User Guide
Last updated Oct 25, 2024

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.

Download

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 docs imageon 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

Installation

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

To connect the Robot and UiPath® Assistant to Orchestrator, use one of the following options:

Note: When using the UiPath® Assistant and Robot on MacOS, local feeds are not supported. Automations are retrieved from Orchestrator and only the cross-platform ones are available. The same applies for the Marketplace Widget when used in the Assistant on MacOS.

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.

Logging

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 Assistant.app/Contents/Robot/uipath.config~/Library/Application Support/UiPath/store.json):
"MAIN_WINDOW_SERVICE_LOGIN_DETAILS": {
        "nextServiceUrl": "https://cloud.uipath.com",
        "defaultServiceUrl": "https://cloud.uipath.com"
    }"MAIN_WINDOW_SERVICE_LOGIN_DETAILS": {
        "nextServiceUrl": "https://cloud.uipath.com",
        "defaultServiceUrl": "https://cloud.uipath.com"
    }

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 Assistant.app/Contents/Robot):
<add key="Telemetry.Enabled" value="false"/><add key="Telemetry.Enabled" value="false"/>

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.