Endpoint Agent Deployment guide for MAC(through MDM)

Last updated: April 13, 2026

All the required packages and configuration files for the Agent deployment will be provided separately by Matters Team. These files are mandatory for the Agent deployment and include the upload_config.sh, fill_client_name.sh, the .mobileconfig file, and the .pkg installer file.

Start by setting up the dashboard configurations.

  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.

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

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

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.

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.

  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.

  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.

  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.

That’s it!