Skip to main content

Install Insightful on macOS via Hexnode

Learn how to install the Insightful desktop app in bulk on company-managed devices with macOS using Hexnode

Marija Djurdjevic avatar
Written by Marija Djurdjevic
Updated yesterday

Hexnode is a Mobile Device Management (MDM) tool designed to help businesses manage, monitor, and secure a wide range of devices.

This document provides a step-by-step guide for deploying a custom configuration profile policy and Insightful deployment to end users. Prerequisites are to have targeted users and devices enrolled through Hexnode and connected.

Step 1: Deploy a Configuration profile

A Configuration profile is a settings file used to configure devices. Deploying it on your employees' macOS devices will ensure that the necessary permissions are enabled for Insightful to function properly.

You can find instructions for obtaining the configuration profile in our article on How to handle macOS permissions remotely via configuration profiles.

After you obtain configuration profiles from our Support team, please follow the next steps for deploying them via Hexnode:

  1. Open the Hexnode dashboard.

  2. Navigate to Policies and select New Blank Policy.

  3. Provide a policy name and description (optional).

  4. Go to iOS > Configurations > Deploy Custom Configuration.

  5. Click Configure, and then select Choose File.

  6. Add configuration profiles provided by the Support Team by clicking on Choose file, followed by the Upload button.

  7. Click OK.

  8. Upload all configuration profiles provided by the Support Team.

  9. Navigate to Policy Targets.

  10. Associate all policies with configuration profiles with the required devices/device groups/users/user groups/domain.

  11. Click Save.

Step 2: Create the installation script

  1. Write the shell script on your local device using Visual Code, Notepad++, or another text/code editor, following the next steps:

    • Put #!/bin/bash in the first line of the script.

    • Go to your Insightful admin dashboard:

      • Go to the Employees tab.

      • Click on the Add New Employee button.

      • Select Company Computers.

      • Select macOS.

      • Copy the code you see using Copy Code.

      • Paste the code in the second line of the shell script.

    • Save the script under insightful_installation.sh name.

Step 3: Deploy the installation script

  1. Open the Hexnode dashboard.

  2. Go to Content page

  3. Open Scripts and click Add.

  4. Select Upload.

  5. Choose the previously created script (insightful_installation.sh).

  6. Click Save, and the script will appear in the list.

  7. Go to the Manage page and select the desired devices, users, device groups, etc.

  8. Click on Action.

  9. Search for Others and select Execute Custom Script.

  10. In the new pop-up, select the Hexnode repository and choose the script (insightful_installation.sh).

  11. In the Binary path type: /bin/bash and click Execute.

Step 4: Monitoring Script Installation

Once you have accessed the script installation page, you can easily monitor the installation of your script. Hexnode provides a status indicator that shows whether the script has been successfully installed on your devices. The status indicator will be displayed next to the name of the script.

If the status indicator shows a green checkmark, it means that the script has been successfully installed on all devices. If the status indicator shows a red exclamation mark, it means that the script has failed to install on one or more devices. You can click on the status indicator to view a detailed report of the installation status on each device.

Did this answer your question?