Note: the Mac Agent is currently in beta. There are known issues noted below. Only upgrade to this if you are comfortable with them.
Feature Matrix against the Windows Agent
|Native Checks - Blue Screen||X|
|Native Checks - Antivirus Installed||X||X|
|Native Checks - Application Crashes||X|
|Native Checks - SMART Failure||X||X|
|Native Checks - Low Disk Space||X||X|
|Native Checks - Firewall Enabled||X||X|
|Native Checks - HDD Fragmentation||X||X|
|Native Checks - Device Manager Issues||X|
|Event Log Monitoring||X|
|Resource Monitoring (CPU/Memory)||X||X|
|Agent Status (Online/Offline)||X||X|
|Patch Management (Operating System)||X|
|Application Management (Third Party)||X|
|Service & Process Monitors||X|
|Managed AV - Bitdefender||X||†, ‡|
|Managed AV - Webroot||X||‡|
|Managed AV - Emsisoft||X|
|Syncro Live - Remote Control (native)||X|
|Syncro Live - Task Manager||X|
|Syncro Live - Terminal (Command Prompt)||X|
|Agent Icon with Menu - Customizable icon/menu||X||X|
|Agent Contact Form||X||X|
|Scripting Engine - Powershell||X|
|Scripting Engine - VBScripts||X|
|Scripting Engine - Batch files||X|
|Scripting Engine - Bash (Mac)||X|
|Scheduled Scripts (on Policy or manual schedule)||X||X|
|System Checks - External Monitoring (ping/http)||X||X|
|Remote Control - "Bring your own" TeamViewer||X||X|
|Remote Control - "Bring your own" ScreenConnect||X||*|
|Remote Control - "Bring your own" Splashtop||X|
|Agent Silent Install||X||X|
|Agent Auto Updating||X||X|
† Requires macOS Full Disk Access Permission at Install
‡ Does not support silent uninstallation
Q: What macOS versions does the Mac Agent support?
A: Just like Apple, we'll ensure that the Mac Agent supports the current version and the prior three versions. Currently, our agent supports Big Sur (11), Catalina (10.15), Mojave (10.14) and High Sierra (10.13). The Mac Agent supports the Apple M1 processor.
Q: How do I install the Mac Agent?
- Navigate to the Customers tab.
- Search for a customer and click their name.
- In the upper right, click New > RMM Agent Installer.
- Click one of the policies to install, then click Mac V2 Beta (PKG).
- When it finishes downloading, double click the SyncroDesktop-[[XXXXX]].pkg file to launch it.
- Follow the installation prompts.
- During the installation, you will likely be prompted to enable Full Disk Access and Screen recording permissions.
Next to Full Disk Access, click Enable.
- If it does not automatically open the Security & Privacy settings, click Provide permissions.
- In the Security & Privacy settings, you will see either a SyncroMSP or dotnet setting. Click the checkbox to its left to enable it.
- Go back to Syncro and click Enable for Screen recording.
- If this Screen Recording dialog appears, click Open System Preferences.
- Just like you did for Full Disk Access, check the box to the left of SyncroMSP or dotnet for Screen Recording.
- Once you have enabled the permissions, the Provide permissions dialog will change to your logo and you may close it.
Q: How do I silently install the Mac Agent?
A: To install the agent silently and bypass the 'Screen Recording' permission, you may use the Terminal command:
touch /tmp/syncro-noui && sudo installer -target / -pkg /path/to/installer.pkg
Or, you can add the suffix .noui. to the PKG file name before running the installer
Should the customer attempt to include an image of their screen from the Agent Contact Form with the 'Screen Recording' permission disabled, they'll be prompted to enable it in the 'Security & Privacy' settings prior to submitting the form. The Asset Screenshot Thumbnail will not be displayed on the Asset Detail page for any agent with the 'Screen Recording' permission disabled.
Q: What managed antivirus integrations does the Mac Agent support?
A: The Mac Agent supports remote installation of our Bitdefender and Webroot integrations if enabled. The agent does not currently support remote uninstallation of either antivirus, but we're currently investigating support for this for both the Bitdefender and Webroot integrations. For now, the managed antivirus will need to be manually uninstalled from the endpoint.
Note: In order for Bitdefender to function correctly on a macOS system, you will need to grant Bitdefender 'Full Disk Access' in the macOS 'Security & Privacy' settings after install. More information on configuring Bitdefender for macOS here:
Q: Is Syncro Live supported?
A: Syncro Live and its suite of tools will not be supported in our Mac Agent. Currently, our TeamViewer and ScreenConnect integrations are supported and we have planned improvements to our remote access functionality which will may be included as part of the Mac Agent sometime in the future.
Q. Is the Script Module supported?
A. Yes, the Script Module is supported for Mac Scripts run on the Mac Agent.
With the Mac Script File Type selected, a ‘Mac Script Quick Help’ section will appear at the bottom of the Script page, documenting the Syntax of the available Module Commands:
Selecting the Mac Script File Type will also automatically inject the ‘#!/bin/bash’ shebang (string) if your Script Editor is empty. However, the shebang is completely optional as the Mac V2 RMM Agent will default to running the script as Bash either way:
Q: Is Syncro Backups supported?
A: Syncro Backups is not currently available for the Mac Agent but this is planned.
Q: Is ScreenConnect/ConnectWise Control supported?
A: Not currently but this is planned.
Q: How do I uninstall the Mac agent?
A: Just like the Windows Agent, deleting the Mac asset from your Syncro account will trigger a remote uninstall of the agent.
We also offer a Bash script for uninstalling the agent available for download here. To run the bash uninstall script:
- Unzip the 'syncro-macv2-uninstall.sh.zip' file.
- Open up macOS Terminal.
- In Terminal, run the command:
chmod 777 /path/to/syncro-macv2-uninstall.sh
- Next, run the command:
- You'll be prompted for the User password. Once entered, the uninstallation process will begin.
Q: When does the Mac Agent launch—at startup or when the user logs in?
A: The new Mac agent will launch at startup regardless if a user logs in or not.
Q: Does the Mac Agent have Native 3rd Party Patch Management?
A: This is not currently planned for the Mac Agent. For users looking to perform Managed software installation for OS X, Munki is a popular option. More information on getting started with Munki: https://www.munki.org/munki/
Q: What is happening to the v1 Beta Agent?
A: The v1 agent will remain available for anyone currently using it. When the new Mac agent is moved from beta status to full release, v1 will be deprecated and all v1 agents will be automatically updated to the new Mac agent.
Note that during this open beta phase no v1 agents will be automatically updated to the new Mac agent.
Q: Can I update my existing v1 agents to the new Mac agent?
A: Yes, if you manually install the new Mac agent on an asset where v1 is currently installed, it will automatically overwrite the v1 agent.
Alternatively, you can upgrade a v1 agent to the new Mac agent in the command line.
In macOS Terminal, enter the following command to upgrade with UI prompts:
curl -L -o /tmp/syncro-setup.pkg https://production.kabutoservices.com/desktop/macos/setup && sudo installer -target / -pkg /tmp/syncro-setup.pkg
To upgrade the v1 agent to the new Mac agent silently, without any UI prompts, run the command:
curl -L -o /tmp/syncro-setup.noui.pkg https://production.kabutoservices.com/desktop/macos/setup && sudo installer -target / -pkg /tmp/syncro-setup.noui.pkg