- Admin guide
- Overview
- Update channels
- Deploy governance policies
- Deploy with Configuration Manager or Intune
- Configure policies on macOS (Preview)
- Configuring the firewall
Configure policies on macOS (Preview)
Configure the UiPath Platform Installer governance policies and installation settings on macOS through a configuration profile deployed by your device management (MDM) solution.
The UiPath Platform Installer for macOS is in Public Preview. Preview features are not recommended for production use.
On macOS, you configure the UiPath Platform Installer policies with a configuration profile, deployed through your device management (MDM) solution. The governance policies are the same as on Windows. For what each one does, refer to Governance controls.
Available settings
Use the preference domain com.uipath.platform. Key names are case-sensitive.
Governance policies
The UiPath Platform Installer applies these settings while it runs.
| Key | Type | Description |
|---|---|---|
AutoUpdateDisabled | Boolean | true turns off automatic updates. An update that is already downloading or installing still finishes. |
Channel | String | Update channel the Mac must use: sts, community, or preview. Locks the channel, so users cannot change it. A channel name that is not in the channel list of the Mac stops updates. |
DownloadRootLocation | String | Internal mirror to download updates from, instead of UiPath. An https:// URL is recommended; a file:// URL to a local folder also works. The mirror must have the same layout as https://download.uipath.com/connected-installer-macos/packages. |
MaxAllowedVersion | String | Highest version Macs can update to, for example 26.10.581. |
MaxPostponeDays | Integer | Days users can postpone an update. 0 turns off postponing. Default: 1. |
Installation settings
The installer package reads these settings when it runs. They do not affect a Mac that is already installed, except TelemetryDisabled.
| Key | Type | Description |
|---|---|---|
InstallMode | String | silent installs without opening the UiPath Installer window. wizard always opens the window. First installation only. |
InstallProducts | Array of strings | Products to install, from Studio and Assistant. Studio always installs Assistant too. First installation only. |
TelemetryDisabled | Boolean | true turns off usage data collection. Applies at installation and each time the UiPath Platform Installer updates itself. |
If you deploy the installer package through an MDM install command, set InstallMode to silent. Otherwise, the UiPath Installer window opens on Macs where a user is signed in, and a user who cancels it removes the installation.
The settings apply to the whole Mac.
Deploy the settings
UiPath provides two sample files in the macos folder of the policy template archive:
com.uipath.platform.plist— a preference file to upload to a custom settings payload.UiPathPlatform.mobileconfig— a complete, unsigned configuration profile.
Every setting in the samples is commented out. Uncomment only the settings you want to enforce, and replace the example values.
-
In your MDM solution, create a configuration profile with a custom settings payload (for example, Application & Custom Settings in Jamf Pro, or a Preference file in Microsoft Intune).
-
Set the preference domain to
com.uipath.platform. -
Add the settings you want. For example:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Channel</key> <string>sts</string> <key>MaxPostponeDays</key> <integer>3</integer> <key>InstallMode</key> <string>silent</string> </dict> </plist><?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Channel</key> <string>sts</string> <key>MaxPostponeDays</key> <integer>3</integer> <key>InstallMode</key> <string>silent</string> </dict> </plist> -
Scope the profile to devices, not to users.
-
Assign the profile to your Macs.
Result
The UiPath Platform Installer reads the governance policies each time it checks for updates, every 15 minutes by default. No restart is needed. Installation settings apply the next time the installer package runs on the Mac.
Settings delivered to a user, instead of to the device, are ignored.
Check the applied settings
On a managed Mac, run:
defaults read "/Library/Managed Preferences/com.uipath.platform"
defaults read "/Library/Managed Preferences/com.uipath.platform"
The output lists the settings delivered by the configuration profile. The UiPath Platform Installer ignores the file if it is not owned by root, or if users other than root can change it.
Set defaults on unmanaged Macs
On a Mac without MDM, you can write the same keys to /Library/Preferences/com.uipath.platform with sudo defaults write. These values are defaults, not policies:
- Settings from a configuration profile take precedence over them.
Channelsets only the channel of the first installation, and does not lock it.
For examples, refer to Install on macOS.