- User guide
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.
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.
| Channel | Use for | Installer package |
|---|---|---|
| Enterprise STS | Enterprise edition, latest features | https://download.uipath.com/connected-installer-macos/latest/sts/UiPathPlatformSTS.pkg |
| Community | Community edition | https://download.uipath.com/connected-installer-macos/latest/community/UiPathPlatformCommunity.pkg |
| Preview | Early access to versions before they reach the Community and STS channels | https://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
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.
- Open the downloaded package and follow the prompts.
- When the UiPath Installer window opens, select the products to install.
- Optionally, select Advanced configuration to change the installation folder or to turn off automatic updates.
- Select I accept the terms in the License Agreement.
- Select Install.
- 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.
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
- Open UiPath Installer from the Applications folder.
- Select or clear the products you want to add or remove.
- 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.
| Permission | Application | Why it is needed |
|---|---|---|
| Accessibility | UiPath UIAutomation, UiPath Assistant | Required to interact with other applications. |
| Screen & System Audio Recording (Screen Recording on macOS 14) | UiPath UIAutomation, UiPath Assistant | Recommended, for screenshots, image targeting, and recordings. |
| Automation | UiPath Assistant, UiPath Studio | Asked the first time an application is controlled. Select Allow. |
| Full Disk Access | UiPath Assistant | Optional, for automations that use files in protected folders. |
| Microphone | UiPath Assistant | Optional, 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.
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.
| Key | Type | Effect |
|---|---|---|
InstallProducts | Array of strings | Products to install, for example Assistant. In the UiPath Installer window, these products are selected by default. First installation only. |
InstallMode | String | silent installs without a window. wizard opens the UiPath Installer window, also from the command line. First installation only. |
Channel | String | Update channel for the first installation, instead of the channel of the package. This option accepts sts, community, and preview. |
TelemetryDisabled | Boolean | true 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.
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.