Configuring Managed OS for macOS

By Katelyn Husvar

Learn how to configure Managed OS for macOS for your supervised device fleet.

Enabling Managed OS for macOS in your Library

Deploying and enforcing an OS version is as easy as adding an OS to your library and assigning it to a Blueprint. Follow the steps below.

  1. Navigate to Library in the left-hand navigation bar.
  2. Select Add New in the upper right-hand corner.



  3. Scroll down to the Operating Systems section and select your desired OS.



Kandji supports adding the same Managed OS to your Library multiple times. This is useful when it's desired to configure differing settings for different Blueprints. For example, you can make a Managed OS automatically upgrade devices in one Blueprint while having it be available in Self Service in another. Labels are used to differentiate multiple copies of the same Managed OS. See below for additional information.

Configuring Managed OS for macOS

  1. Enter a Label to help differentiate this instance of Managed OS for macOS from others in your Library. These labels are not visible to end-users, but are displayed throughout the Kandji admin interface.
  2. Assign the Managed OS to a Blueprint.
  3. Configure how upgrade installations of this major version of macOS should be enforced. Continuously Enforce will automatically initiate an upgrade on older versions of macOS, or users can upgrade on their own if you choose Install on-demand from Self Service. This is an option that can easily be differentiated between Blueprints by making additional copies of the same Managed OS for macOS. (Add unique and descriptive labels to help you identify them.)
  4. Under Updates, select an option for Version Enforcement. Available options include the following:

    • Do Not Manage: This option will not manage OS updates.
    • Automatically Enforce New Updates: You will also select a Time frame in which new updates will be enforced.
    • Manually Enforce Minimum Version: Specify the minimum version a device should be running and the Enforcement Deadline date by which users must update. If a device is already running an OS version greater than the minimum that you specify, no updates will be enforced.

      Automatically Enforce New Updates and Manually Enforce a Minimum Version set a minimum OS version, or "floor," for which to compare a device's Os version to determine if it should update. The floor is automatically calculated based on the date Apple releases an update. When updating, Kandji always installs the latest available version of macOS that is approved by Kandji (which is displayed in the upper-right-hand corner of the Library Item).

      When a new update is released, it will be automatically cached on your users' devices 5 days before the enforcement deadline. End-users will be notified of the pending installation after the app is successfully cached. They will continue to be notified each day leading up to enforcement.


      If you select an Enforcement timeframe or Enforcement deadline less than 5 days, from when an update is released by Kandji, it will be be automatically cached on your end-users' devices, and they will be notified of the pending installation.

  5. Select an Enforcement Time Zone to determine when to enforce the update.

  6. Select an Enforcement Time, which will be the exact time of day that the update is enforced; the enforcement will be determined server-side based on the previously selected Enforcement Time Zone.

  7. Click Save.



If this is the first time you are enforcing an OS version on your fleet, we recommend using the Manually Enforce Minimum Version option and setting the enforcement deadline to at least 5 days later. Otherwise, if you select the Automatically Enforce New Updates option and set it to 2 weeks (as an example), and Apple hasn’t released an update in the last two weeks, all of your devices will immediately require users to update and restart.
To learn more about Managed OS for macOS, please see our other support articles:
Managed OS for macOS Compatibility and Installation Mechanisms
User Experience with Managed OS for macOS