UiPath Documentation
uipath-platform-installer
latest
false
UiPath Platform Installer admin guide
  • 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.

Important:

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.

KeyTypeDescription
AutoUpdateDisabledBooleantrue turns off automatic updates. An update that is already downloading or installing still finishes.
ChannelStringUpdate 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.
DownloadRootLocationStringInternal 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.
MaxAllowedVersionStringHighest version Macs can update to, for example 26.10.581.
MaxPostponeDaysIntegerDays 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.

KeyTypeDescription
InstallModeStringsilent installs without opening the UiPath Installer window. wizard always opens the window. First installation only.
InstallProductsArray of stringsProducts to install, from Studio and Assistant. Studio always installs Assistant too. First installation only.
TelemetryDisabledBooleantrue turns off usage data collection. Applies at installation and each time the UiPath Platform Installer updates itself.
Important:

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.

  1. 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).

  2. Set the preference domain to com.uipath.platform.

  3. 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>
    
  4. Scope the profile to devices, not to users.

  5. 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.

Note:

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.
  • Channel sets only the channel of the first installation, and does not lock it.

For examples, refer to Install on macOS.

  • Available settings​
  • Governance policies​
  • Installation settings​
  • Deploy the settings​
  • Check the applied settings​
  • Set defaults on unmanaged Macs​

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