About the Syncro Mac Agent

Just like Apple, we'll ensure that our Mac Agent supports the current version and the prior three versions. See our Supported Versions document for specifics.

Note: The Mac Agent launches at startup, whether a user logs in or not.

Managed AV Integrations

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. For now, the managed antivirus will need to be manually uninstalled from the endpoint.

Note: For Bitdefender to function correctly on a macOS system, you need to grant Bitdefender “Full Disk Access” in the macOS “Security &Privacy” settings after install. Learn more about configuring Bitdefender for macOS.

Backgrounding Tools

Backgrounding Tools are not supported in our Mac Agent; our TeamViewer integration is supported.

Script Module Support

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 RMM Agent will default to running the script as Bash either way:

Third-Party Patch Management

This is not currently planned for the Syncro Mac Agent. If you're looking to perform managed software installation for OS X, Munki is a popular option. 

Install the Mac Agent

 To install the Syncro Mac Agent, follow these steps:

1. Navigate to the Customers tab.
2. Click a customer's Name/Business to open their Customer Details Page.
3. Select RMM Agent Installer from the +New button menu:
   
4. Select a Policy Folder containing the policy you'd like to attach to the installer. By default, the top-level Policy Folder is selected.
5. Select the Mac (PKG) radio button, then click Get RMM Installer.
6. When it finishes downloading, double-click the SyncroDesktop-[[XXXXX]].pkg file to launch it.
7. Follow the installation prompts.
   Note: During the installation process, you may be prompted to enable Full Disk Access and/or Screen Recording permissions. Next to each, click Enable:
   
   Note: Click Skip only if these permissions already show “Enabled!”
8. If the installer does not automatically open the Security & Privacy settings, click Provide Permissions.
9. In the Security & Privacy settings, locate and check the box to the left of SyncroMSP to enable it:
   1. If you don't see SyncroMSP listed inside Full Disk Access, click the + below the list (you may need to unlock the lock in the lower left first).
   2. From the drive selector at the top, select Macintosh HD:
   3. Click Library > Application Support > SyncroMSP > SyncroMSP:
      
   4. Click Open.
10. Return to Syncro, and if it's there by Screen recording, click Enable. 
11. If this Screen Recording dialog appears, click Open System Preferences:
    
12.  As you did for Full Disk Access, check the box to the left of SyncroMSP for Screen Recording:
13. Once you've enabled the permissions, the Provide Permissions dialog will change to your logo and you may close it.

Silently Install the Mac Agent

To install the Mac agent silently, 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 (for example: SyncroDesktop-[[...]].noui.pkg).

Notes: 

At some point, the Screen Recording permission will need to be enabled. 

• Should your end user attempt to include an image of their screen from an 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 Details page for any agent with the Screen Recording' permission disabled.

Deploy the Mac Agent Using a Script

To deploy the Mac Agent using a script, follow these steps:

1. Navigate to the Customers tab.
2. Click a customer's Name/Business to open their Customer Details Page.
3. Select RMM Agent Installer from the +New button menu:
   
4. Select a Policy Folder containing the policy you'd like to attach to the installer. By default, the top-level Policy Folder is selected.
5. Select the Mac (PKG) radio button.
6. Copy the token's GUID from the end of the URL.
7. Close the dialog.
8. In the script below, replace TOKEN_GUID with the GUID you copied. It would look like this: 
   POLICY_ID=e782da9b-6829-30c1-17f4-84a89d4ba3c

Example Script

Here's an example script you can paste into your existing deployment workflow. (Modify as needed.)

#!/bin/bash POLICY_ID=TOKEN_GUID
echo $POLICY_ID > /tmp/syncro-deploy-id && \
/usr/bin/curl -L1 https://production.kabutoservices.com/desktop/macos/setup? token=$POLICY_ID -o
/tmp/SyncroDesktop.pkg && \
/usr/sbin/installer -target / -pkg /tmp/SyncroDesktop.pkg && \
/bin/rm /tmp/SyncroDesktop.pkg && \
/bin/rm /tmp/syncro-deploy-id && \ echo "Syncro Agent Installed!"

Restart the Mac Agent

Use the following command to restart the Syncro Mac service: 

sudo /usr/local/bin/syncro restart

Uninstall the Mac Agent

Like the Syncro Windows Agent, deleting a Mac asset from your Syncro account will trigger a remote uninstall of the agent.

You can also uninstall it locally by following these steps:

1. Launch Terminal.app.
2. In Terminal, run the command: 
   sudo syncro uninstall
3. You'll be prompted for the User password. Once entered, the uninstallation process will begin.