Endpoint Agent deployment guide for Mac

Last updated: April 30, 2026

All the packages and config files will be shared by Matters team which we will be requiring for MDM deployment. It contains an upload_config.sh , fill_client_name.sh , mobileconfig file and the pkg

First we will have to do some configurations on the dashboard side:

  1. Fill the configuration page as shown below. Keep the Scan Folder Path as shown: ${USER_HOMES}/Desktop would mean that it would scan all the files inside the desktop folder.

image.png

  1. Go to the assist page and create an assist. Keep the type as Export .

image.png

  1. Once you create an assist a pop up will appear with the client_id and client_secret . Copy these in a secured place.

image.png

That’s all on the dashboard side!

Changes in the script:

  1. Copy paste the client_id and client_secret that we just created in the upload_config.sh in line 23-24.

image.png

MDM side steps:

All of these steps should be done in order.

  1. First we need to apply the mobileconfig policy file. This will ensure that our agent once installed is granted full disk access which is required for scanning the files.

image.png

  1. Second we will have to run the upload_config.sh shell script which will contain the config file for the agent. Note to run it as a root user.

image.png

  1. Once Step 2 is done we will have to run the fill_client_name.sh script. Again we have to run it as a root user.

  2. Once Step 3 is done we can upload the pkg under software management and attach the devices and trigger the deployment.

image.png

  1. To test in the client device that the package has been deployed successfully you should be able to see the Matters AI Security in the applications.

  2. To verify that the agent is running once it has been deployed we can open the terminal and hit this CURL:

curl -X GET <http://localhost:5001/status>

This should return is_active: true .

Once all this is done you should be able to see your device in the dashboard.

image.png

That’s it!