UiPath Documentation
uipath-platform-installer
latest
false
UiPath Platform Installer user guide
  • User guide
    • Introduction
    • Install the desktop clients
    • Install from the command line
    • Install on macOS (Preview)
    • Migrate from the classic MSI
    • Postpone an update

Install on macOS (Preview)

Install UiPath Studio and UiPath Assistant on macOS with the UiPath Platform Installer package, choose an update channel, grant the required macOS permissions, and keep the desktop clients up to date automatically.

Important:

The UiPath Platform Installer for macOS is in Public Preview. Preview features are not recommended for production use.

On macOS, the UiPath Platform Installer installs UiPath Studio and UiPath Assistant, and keeps them up to date automatically. Assistant runs your automations. Studio requires Assistant, so selecting Studio always installs Assistant too. You can also install Assistant on its own.

Prerequisites​

  • A Mac with Apple silicon (M1 or later). Intel-based Macs are not supported.
  • macOS 14 Sonoma or later.
  • At least 8 GB of free disk space.
  • Administrator rights, if you install for all users of the Mac.

Download the installer​

Each update channel has its own installer package, which places the Mac on that channel. You can change the update channel after installation.

ChannelUse forInstaller package
Enterprise STSEnterprise edition, latest featureshttps://download.uipath.com/connected-installer-macos/latest/sts/UiPathPlatformSTS.pkg
CommunityCommunity editionhttps://download.uipath.com/connected-installer-macos/latest/community/UiPathPlatformCommunity.pkg
PreviewEarly access to versions before they reach the Community and STS channelshttps://download.uipath.com/connected-installer-macos/latest/preview/UiPathPlatformPreview.pkg

The Enterprise LTS channels are not available on macOS.

You can also download the macOS installer package from the Resource Center in UiPath Automation Cloud.

Install Studio and Assistant​

Note:

By default, the products are installed for all users of the Mac. To install them only for yourself, on the Installation Type step, select Change Install Location, and then select Install for me only.

  1. Open the downloaded package and follow the prompts.
  2. When the UiPath Installer window opens, select the products to install.
  3. Optionally, select Advanced configuration to change the installation folder or to turn off automatic updates.
  4. Select I accept the terms in the License Agreement.
  5. Select Install.
  6. Wait until the window shows Installation complete. The first installation downloads the full products, so it takes longer than later updates.

Result

UiPath Studio, UiPath Assistant, and UiPath Installer are added to your Applications folder. The product files are stored in the UiPath folder inside Applications.

Note:

A Mac can have only one installation, either for all users or for you only. The installer refuses a second installation in the other scope. To switch, uninstall first.

Add or remove products​

  1. Open UiPath Installer from the Applications folder.
  2. Select or clear the products you want to add or remove.
  3. Select Modify.

Grant macOS permissions​

macOS asks you to approve some permissions before UiPath can automate other applications. When prompted, open System Settings > Privacy & Security and turn on the permission for the application shown.

PermissionApplicationWhy it is needed
AccessibilityUiPath UIAutomation, UiPath AssistantRequired to interact with other applications.
Screen & System Audio Recording (Screen Recording on macOS 14)UiPath UIAutomation, UiPath AssistantRecommended, for screenshots, image targeting, and recordings.
AutomationUiPath Assistant, UiPath StudioAsked the first time an application is controlled. Select Allow.
Full Disk AccessUiPath AssistantOptional, for automations that use files in protected folders.
MicrophoneUiPath AssistantOptional, for voice and audio features.

UiPath UIAutomation is the UiPath component that interacts with other applications. It appears in the permission lists the first time you indicate a UI element in Studio or run a UI automation.

After you turn on a permission, quit and reopen Studio and Assistant.

Install from the command line​

When you run the package with the installer command, the installation is silent: no window opens, and the default products of the channel, Studio and Assistant, are installed.

To install for all users, run:

sudo installer -pkg UiPathPlatformSTS.pkg -target /
sudo installer -pkg UiPathPlatformSTS.pkg -target /

To install only for the current user, run:

installer -pkg UiPathPlatformSTS.pkg -target CurrentUserHomeDirectory
installer -pkg UiPathPlatformSTS.pkg -target CurrentUserHomeDirectory

Device management tools that run the installer command, such as Jamf Pro and Munki, install silently in the same way.

Important:

An MDM install command, which macOS runs without the installer command, opens the UiPath Installer window when a user is signed in to the Mac, and canceling it removes the installation. To install silently through MDM, set InstallMode to silent in a configuration profile first. For details, refer to Configure policies on macOS.

Installation settings​

To change how the package installs, write settings to the com.uipath.platform preference domain before you run it. The installer command does not pass environment variables to the package.

KeyTypeEffect
InstallProductsArray of stringsProducts to install, for example Assistant. In the UiPath Installer window, these products are selected by default. First installation only.
InstallModeStringsilent installs without a window. wizard opens the UiPath Installer window, also from the command line. First installation only.
ChannelStringUpdate channel for the first installation, instead of the channel of the package. This option accepts sts, community, and preview.
TelemetryDisabledBooleantrue turns off usage data collection. Applies at installation and each time the UiPath Platform Installer updates itself.

For an installation for all users, write the settings to /Library/Preferences/com.uipath.platform with sudo. For example, to install only Assistant and turn off usage data collection:

sudo defaults write /Library/Preferences/com.uipath.platform InstallProducts -array Assistant
sudo defaults write /Library/Preferences/com.uipath.platform TelemetryDisabled -bool true
sudo installer -pkg UiPathPlatformSTS.pkg -target /
sudo defaults write /Library/Preferences/com.uipath.platform InstallProducts -array Assistant
sudo defaults write /Library/Preferences/com.uipath.platform TelemetryDisabled -bool true
sudo installer -pkg UiPathPlatformSTS.pkg -target /

For an installation for the current user only, run defaults write com.uipath.platform with the same keys, without sudo.

The settings remain on the Mac until you delete them, and later first installations use them too. To delete them, run sudo defaults delete /Library/Preferences/com.uipath.platform, or defaults delete com.uipath.platform for the current user. Usage data collection stays off after you delete the settings. To turn it back on, set TelemetryDisabled to false, and then run the installer package again.

Updates​

Updates download in the background. When an update is ready, a UiPath Update Required window lists the products to update and the time by which the update is applied automatically:

  • Select Update now to save your work and update immediately. The listed applications close, and reopen after the update.
  • Select Later to postpone the update, if your organization allows it.

If the screen is locked when an update that you can postpone is ready, the window waits until you unlock the Mac. After a successful update, a UiPath Platform Updated notification is shown.

Administrators can control updates through a configuration profile. For details, refer to Configure policies on macOS.

Change the update channel​

After installation, you can change the update channel from the command line, without reinstalling.

For an installation for all users, run:

sudo "/Applications/UiPath/Updater/UiPath.Connected.MacOS.Updater.MacOsCli" set_channel -channel sts
sudo "/Applications/UiPath/Updater/UiPath.Connected.MacOS.Updater.MacOsCli" set_channel -channel sts

For an installation for the current user only, run:

"$HOME/Applications/UiPath/Updater/UiPath.Connected.MacOS.Updater.MacOsCli" set_channel -channel sts -perUser
"$HOME/Applications/UiPath/Updater/UiPath.Connected.MacOS.Updater.MacOsCli" set_channel -channel sts -perUser

The channel names are sts, community, and preview.

The new channel is used for subsequent updates.

Note:

If your organization sets the update channel through a configuration profile, the channel is locked and the command is rejected.

Uninstall​

Dragging the applications to the Trash does not fully remove them. Instead, run:

sudo "/Applications/UiPath/Updater/uninstall.sh"
sudo "/Applications/UiPath/Updater/uninstall.sh"

For an installation for the current user only, run "$HOME/Applications/UiPath/Updater/uninstall.sh" without sudo.

On installations from before October 2026 that have not updated yet, the folder is named UiPath Connected instead of UiPath. Use that folder in the path.

Collect logs​

If you contact UiPath support, include a diagnostics archive. To create one, run the following command as your own user, without sudo:

"/Applications/UiPath/Updater/collect-diagnostics.sh"
"/Applications/UiPath/Updater/collect-diagnostics.sh"

For an installation for the current user only, run "$HOME/Applications/UiPath/Updater/collect-diagnostics.sh".

The script asks for confirmation, and for an administrator password if the installation is for all users. It saves the archive to your Desktop as UiPathPlatformDiag-<id>.zip. If an installation fails, you can also select Collect Logs in the UiPath Installer window.

The log files are in /Library/Logs/UiPathConnected, or in ~/Library/Logs/UiPathConnected for an installation for the current user only.

Was this page helpful?

Connect

Need help? Support(opens in new window)

Want to learn? UiPath Academy(opens in new window)

Have questions? UiPath Forum(opens in new window)

Stay updated