Skip to main content

macOS

To get started with the UXM Endpoint agent on macOS, please make sure you meet the prerequisites below.

Prerequisites​

OS requirements​

To install UXM Endpoint agent, you need the 64-bit version of one of these macOS versions:

  • macOS 15 (Sequoia)
  • macOS 14 (Sonoma)
  • macOS 13 (Ventura)
  • macOS 12 (Monterey)
  • macOS 11 (Big Sur)

UXM Endpoint agent is compatible with 64-bit Intel based architectures.

Installation methods​

You can install the UXM Endpoint agent in different ways, depending on your needs:

Deploy UXM Endpoint agent via Intune (or other deployment tool like Jamf)​

Intune

Before you install UXM Endpoint agent for the first time on a new host machine, you need to set up the UXM repository. Afterward, you can install and update UXM from the repository.

Create plist with configurations

  1. Open https://intune.microsoft.com/ and goto Devices -> macOS -> Configuration
  2. Create new policy or edit existing UXM Endpoint Agent policy.
  3. Select Template profile type and Preference file

  1. Basics: Fill out name and description

Name: UXM Endpoint Agent
Description: Settings for UXM Endpoint Agent

  1. Configuration settings

Preference domain name: com.uxmapp.pcagent
Property list file: Create file called "com.uxmapp.pcagent.plist" and enter text below with your Agent Key and Collector Url.

Relpace the <string>AgentKeyValue</string> and <string>https://customername.uxmapp.com</string> with the collector url

<key>AgentKey</key>
<string>AgentKeyValue</string>
<key>Collector</key>
<string>https://customername.uxmapp.com</string>
<key>VerifyHTTPs</key>
<true/>
<key>SynchronizeIntervalMinutes</key>
<integer>60</integer>

Upload the created file

  1. Assignments:

Select all devices to deploy to all macOS'es enrolled in Intune or add filter for limited rollout.

  1. Review + create: Press create to deploy configuration file

The profile will be placed under /Library/Managed Preferences/com.uxmapp.pcagent.plist when deployed to machines

Deploy package

  1. Download newest UXM Endpoint Agent from https://download.uxmapp.com/macos/stable/
  2. Open https://intune.microsoft.com/ and goto Apps -> macOS
  3. Click Add and select Other -> macOS app (pkg) app type

  1. App information:

Select the downloaded pkg file and set Publisher to "Systemslab ApS"
Name and description: UXM Endpoint Agent (x64, pkg)
Publisher: Systemslab ApS

  1. Program: Skip Program Pre/Post scripts
  2. Requirements: Set minimum os to macOS Big Sur 11.0
  3. Detection rules: Leave defaults

  1. Assignments:

Select all devices to deploy to all macOS'es enrolled in Intune or add filter for limited rollout.

  1. Review + create: Press create to deploy app

Monitor rollout

Open the app to see how many devices the agent is rolled out to, they will be available in UXM if configuration plist is correctly deployed.

Upgrade deployed app

  1. Download newest UXM Endpoint Agent from https://download.uxmapp.com/macos/stable/
  2. Open https://intune.microsoft.com/ and goto Apps-> macOS
  3. Select the UXM Endpoint Agent app

  1. Press Properties -> Edit
  2. Select file to update and upload the new pkg.

  1. Goto Review + Save and press Save

Install manually from a package​

You can download the pkg file for your release and install it manually. You need to download a new file each time you want to upgrade the UXM Endpoint Agent.

  1. Go to https://download.uxmapp.com/macos/

  2. Select the stable in the list.

  3. Download the newest .pkg file for the UXM Endpoint agent version you want to install:

uxm-endpoint-agent_<version>_<arch>.pkg

  1. Run and install the .pkg package

  1. Update pcagent.config with collector and agent key.

Any plist files deployed to machine will override the configuration in pcagent.conf.

export UXM_COLLECTOR=https://customername.uxmapp.com
export UXM_AGENT_KEY=AgentKeyValue
sudo sed -i "" -e "s|{COLLECTOR}|$UXM_COLLECTOR|g" -e "s|{AGENT_KEY}|$UXM_AGENT_KEY|g" /Library/UxmEndpointAgent/pcagent.config
  1. Restart service
sudo launchctl unload /Library/LaunchDaemons/com.uxmapp.pcagent.plist
sudo launchctl load /Library/LaunchDaemons/com.uxmapp.pcagent.plist

Uninstall​

UXM Endpoint agent can be uninstalled with the following commands

sudo bash /Library/UxmEndpointAgent/uninstall.sh

Delete plist settings and service

sudo rm --force /Library/Preferences/com.uxmapp.pcagent.plist
sudo launchctl unload /Library/LaunchDaemons/com.uxmapp.pcagent.plist