macOS Check-In Frequency

Learn how and when macOS devices Check-in with Kandji and Apple services.

Helpful Definitions

  • MDM: Mobile Device Management
  • APNS: Apple Push Notification Services

How "instant" is MDM communication ?

MDM servers send a particular type of notification to APNS to request managed devices to "Check-in" with their MDM server. As part of APNS, Apple devices are constantly polling APNS for Notifications. This results in near-instant management of online devices; as such, there is no defined "Check-in" time for MDM commands.

Check-in type and frequency for macOS devices

Recurring Check-In

  • Frequency: This Check-in event automatically happens every 15 Minutes
  • Mechanism: Kandji Agent
  • Description:
    • Executes and enforces Blueprint parameters
    • Installs any pending library items, such as:
      • Auto Apps
      • Custom Apps
      • Scripts
      • Printers
  • How can I force Recurring Check-in?
    • To force Recurring Check-in, run the following command in Terminal:
        • sudo kandji run

Daily Check-In

  • Frequency: This Check-in event automatically happens every 24 Hours
  • Mechanism: Kandji Agent
  • Description:
    • All recurring Check-in items
    • Daily Items, such as:
      • Custom Scripts
      • Custom Compliance Scripts
    • Collects and submits daily computer information to your Kandji instance, such as:
      • Application inventory
  • How can I force Daily Check-in?
    • To force Daily Check-in, run the following command in Terminal:
        • sudo kandji run -F

Agent Update Check-In

  • Frequency: This Check-in event happens automatically every 20 Minutes
  • Mechanism: Kandji Agent
  • Description:
    • Checks for and installs any available updates for the Kandji Agent. 
  • How can I force Agent Update Check-in?
    • To force Agent Update Check-in, run the following command in Terminal:
      • sudo kandji update

MDM Daily Check-In 

  • Frequency: This Check-in event automatically happens once every 24 hours
  • Mechanism: APNS / MDM Framework
  • Description: This Check-in is a combination of the following MDM Commands, which are automatically initiated by Kandji to update device information:
    • ProfileList
    • InstalledApplicationsList
    • SecurityInfo
    • CertificateList
    • AvaliableOSUpdates
    • DeviceInformation
  • How can I force MDM Daily Check-in?
    • Not applicable for this type of Check-in.

MDM Commands & Profiles

  • Frequency: Instant
  • Mechanism: APNS / MDM Framework
  • Description:
    • Any MDM command such as:
      • Wipe Device
      • Blank Push
      • Delete User 
      • Set Device Name 
      • Unlock User Account
      • InstallApplication (VPP/Apps and Books)
    • Any MDM delivered profile such as:
      • Any Profile deployed via a Library Item.
  • How can I force MDM Commands & Profiles Check-in
    • Not applicable for this type of Check-in.