Skip to main content
This guide applies to all device platforms

About Device Check-In

Iru Endpoint uses different check-in mechanisms depending on the device platform. Each platform has specific check-in types that serve different purposes and occur at various frequencies. Understanding these check-ins helps you track device state, enforce policies, and ensure applications are deployed reliably.

How It Works

Device check-ins are the communication mechanism between managed devices and Iru Endpoint servers. They enable:
  • Policy enforcement and compliance monitoring
  • Application deployment and updates
  • Device inventory collection
  • Configuration profile management
  • Real-time device management commands
The check-in frequency and mechanism vary by platform, with some using agent-based check-ins and others relying on MDM push notifications.

Platform-Specific Check-In Details

Recurring Check-In

Frequency: Every 15 minutes
Mechanism: Kandji Agent
This check-in ensures that the Kandji Agent is up-to-date, executes and enforces Blueprint parameters, and installs any pending library items such as custom scripts, printers, apps, and auto apps. Each item has a specific timeout period for installation.

Order of Operations and Timeouts

Library Items are processed in a specific sequence. Each type of Library Item is handled in an alphanumeric order, with uppercase letters taking precedence over lowercase ones. The timeout values define the maximum time allowed for each Library Item to complete its installation or execution before it is stopped. Additionally, each run is governed by a global timeout limit of 12 hours, which also applies to installations of Custom Apps and Apps and Books initiated through Self-Service.
PriorityOperationTimeout
1Custom Scripts1 hour per item
2Custom Printers3 hours per item
3Custom Apps12 hours (global limit)
4Auto Apps6 hours per item
5Managed OS12 hours (global limit)

Forcing a Recurring Check-In

To force a recurring check-in, run the following command in Terminal:
sudo kandji run

Daily Check-In

Frequency: Every 24 hours
Mechanism: Kandji Agent
This check-in includes all recurring check-in items and additional daily items like custom scripts, compliance scripts, and Blueprint parameters. It also involves securing home folders, checking application and system folders for appropriate permissions, and collecting daily computer information for submission to the Iru Endpoint tenant. The daily check-in follows the same sequence as the recurring one, starting after executing Blueprint Parameters. Once all Library Items are completed, the application inventory is sent back to Iru Endpoint.

Forcing a Daily Check-In

To force daily check-in, run the following command in Terminal:
sudo kandji run --reset-daily
A daily check-in can also be forced using the sync button in Self Service:
1

Open Self Service

Open the Kandji Self Service app.
2

Navigate to Device Info

Navigate to the Device Info section on the left.
3

Click Sync

Click Sync.

MDM Daily Check-In

Frequency: Every 24 hours
Mechanism: Apple Push Notification Service (APNs) / MDM Framework
This check-in involves executing the following MDM commands to update device information:
  • ProfileList
  • InstalledApplicationsList
  • SecurityInfo
  • CertificateList
  • AvailableOSUpdates
  • DeviceInformation

Forcing an MDM Daily Check-In

To force the daily MDM commands, run the following command in Terminal:
sudo kandji update-mdm

MDM Commands & Profiles

Frequency: Instant
Mechanism: APNs / MDM Framework
This check-in allows for instant execution of any MDM command, such as wiping a device, setting a device name, or installing applications. It also includes any profile deployed via a Library Item.

How Instant is MDM Communication?

MDM servers send a unique notification to the Apple Push Notification service, prompting managed devices to check in with their MDM server. Apple devices regularly poll APNs for these notifications, enabling almost immediate management of devices that are online. Consequently, there isn’t a set check-in time for MDM commands, nor is there a way to enforce a check-in.

Troubleshooting Check-In Issues

If devices aren’t checking in as expected, see our Troubleshooting Agent Check-In guide for platform-specific troubleshooting steps.

Best Practices

Monitor Check-In Status

Regularly monitor device check-in status to identify issues early and ensure policy compliance.

Understand Platform Differences

Be aware that different platforms use different check-in mechanisms and frequencies.

Use Force Check-In Sparingly

Force check-ins only when necessary, as they can impact device performance and battery life.

Review Logs Regularly

Check agent and MDM logs to identify patterns in check-in failures or delays.