Skip to main content

Octory settings with MDM

Octory settings can be deployed in two ways, with Octory.plist or a managed configuration profile. This document describes the method to deploy the settings with a managed configuration profile using Jamf Pro, Intune or Workspace ONE. To use this guide the following resources are required:

  • An Octory.plist file with the desired settings configured.
  • Access to an MDM, Jamf Pro, Intune or Workspace ONE.
  • OctoryOnboarding-Template.mobileconfig downloaded from our GitLab Repo.
  • Plain text editor for XML files. This guide will use Code Runner.

Deploy settings with Jamf Pro

This section will describe the steps to create a Custom configuration profile in Jamf Pro to deploy the Octory settings as a configuration profile.

The resources for this section are:

  • Access to Jamf Pro
  • Octory.plist with settings
info

Configuration profiles deployed by the MDM will be installed on the managed Mac computer at /Library/Managed Preferences/. The name of the preference should appear as Octory.plist for Octory.app to be able to read the settings.

Login to Jamf Pro and create a new configuration profile with custom settings: Computers > Configuration Profiles > New

  • Name the configuration profile based on the organization’s naming convention. This guide will name it, Octory - Onboarding.

Folder Initial Setup

Configure the Application and Custom Settings > Upload > Add

  • Enter Octory in the name Preference Domain. This is the name that will appear in Managed Preferences and it is required for Octory to read the settings.

Folder Initial Setup

Open the Octory.plist with the settings, select and copy the dictionary settings.

Folder Initial Setup

Paste the dictionary in the Property List section of the configuration profile.

Folder Initial Setup

note

Alternatively run the command plutil -convert xml1 /PATHTO/Octory.plist and upload the file by clicking the button “Upload”.

Scope to the desired computers and save the configuration profile.

After the installation of the profile the settings will appear in /Library/Managed Preferences/Octory.plist

Folder Initial Setup

Open Octory to confirm the settings are applied.

Folder Initial Setup

Deploy settings with Intune

This section will describe the steps to create a Custom configuration profile in Intune to deploy the Octory settings as a configuration profile.
The resources for this section are:

  • Access to Intune
  • Octory.plist with settings
  • OctoryOnboarding-Template.mobileconfig downloaded from our GitLab Repo

Folder Initial Setup

info

Configuration profiles deployed by the MDM will be installed on the managed Mac computer at /Library/Managed Preferences/. The name of the preference should appear as Octory.plist for Octory.app to be able to read the settings.

Open OctoryOnboarding-Template.mobileconfig with a plain text editor and copy the content content of the file.

Folder Initial Setup

Create a new file with the plain text editor and paste the content of OctoryOnboarding-Template.mobileconfig and save the file with .mobileconfig extension, for this example will be Octory-onboarding.mobileconfig.

Folder Initial Setup

Open the Octory.plist with the settings, select and copy the dictionary settings.

Folder Initial Setup

Paste the dictionary in line 16 (Insert your Octory.plist settings dictionary) of the Octory-onboarding.mobileconfig file. Save the file.

Folder Initial Setup

Open Intune and create a new Configuration Profile for macOS, Devices > macOS > Configuration profiles > Create > New Policy > Templates > Custom > Create

Folder Initial Setup

Name the configuration profile based on the organization’s naming convention. This guide will name it, Octory - Onboarding and click Next.

Folder Initial Setup

Name the Custom configuration profile name as Octory, this name will be read by Octory.app. Any other name will make Octory.app open with an error.

Folder Initial Setup

Upload the Octory-onboarding.mobileconfig file and click Next.

Folder Initial Setup

Folder Initial Setup

Assign the groups for the devices that will receive the Configuration profile and click Next and Create.

Folder Initial Setup

Confirm the installation of the configuration profile on a managed Mac computer.

Folder Initial Setup

Folder Initial Setup

After the installation of the profile the settings will appear in /Library/Managed Preferences/Octory.plist

Folder Initial Setup

Open Octory to confirm the settings are applied.

Folder Initial Setup