Skip to main content

Minimum OS version for enrolling Apple devices via ADE

What

MDMFileWave serverscan have the ability to enforcerequire a minimum operating system version on enrolling devices when usingduring Automated Device Enrollment (ADE).  ThisDuring feature was added in FileWave version 15.1.0 for macOS 14.0 Sonoma and iOS/iPadOS 17.0. Apple does not support this feature on older versions of macOS or iOS/iPadOS.

When/Why

Minimum OS version allows to ensure that devices are onenrollment, the necessary OS version before being put into production. The MDM willserver sendcan areturn JSONApple's 403required software update response when the device requestsis below the enrollmentconfigured profile.minimum version. The device then guides the user through the required update before Setup Assistant can continue.

Apple supports this minimum-version ADE workflow on devices running iOS 17, iPadOS 17, macOS 14, visionOS 26, or later. Older operating systems cannot use this ADE enforcement behavior.

When/Why

Use a minimum OS version when organization-owned devices must be updated before they enter production. If the minimum operating system versiondevice is needed,below the userrequired willversion, beenrollment guided through a process of updatingpauses, the device.update Restartsruns, will be performed automatically. Once completed,and the device returns to Setup Assistant andafter the update so the user can finish the enrollment and setup process.enrollment.

How

WithIn FileWave 15.1.0 support of minimum OS version was added. To specify minimum OS versionsCentral, open the DEP profile and go to Options > Requirements. section.Enter Therethe areminimum separate fieldsversion for macOS and/or iOS/iPadOS. Use Apple's version format for the target operating system, and iOSchoose /a iPadOSversion minimumthat OSis versions.actually available for the device.

image.pngFileWave DEP Profile window showing minimum OS version requirements.

TheYou can also specify supplemental version identifiers can be specified in addition to the standard MAJOR.MINOR.PATCH formatformat. (forFor exampleexample: 17.1 (a)“).

What is displayed on the device?

When minimum OS version is requested bythe MDM server specificrequires dialoga appearsminimum onOS version, the device.device displays Apple's software update or Remote Management flow before enrollment can continue.

For macOS:

image.pngmacOS Software Update screen requiring installation of version 14.1 before continuing.

For iPadOS:

image.pngiPad Remote Management screen stating the device must be updated to iPadOS 17.1.

If a macOS device cannot install requestedthe OSrequired versionversion, nextmacOS dialogdisplays appears:an error dialog:

image.pngmacOS error dialog stating the organization-required update to 14.1 could not be installed.

On iPadOSiPadOS, there is no specificseparate error dialog infor this case,case. justThe “Next“Next button isremains greydisabled, andso nothe wayuser tocannot pass.continue until the requirement can be met.

Digging Deeper

During DEP profile handling, FileWave evaluates MachineInfo from the device is parsed on server side during DEP profile handling.device. If itMachineInfo containsincludes MDM_CAN_REQUEST_SOFTWARE_UPDATE flagset andto it’strue, True,FileWave compares the specifiedDEP profile's minimum OS version fromwith DEPthe profile is compared withdevice's OS_VERSION from MachineInfo according tofor the devicerelevant typeplatform.

(macOS

FileWave orrequests iOS/iPadOS). Softwarean update request is sent to the device by MDM server in 2 cases:when:

  1. IfThe current OS version is lesslower than the minimum OS version

    version.
  2. IfThe current OS version equals the minimum OS versionversion, but the current supplemental version identifier is lesslower than the required supplemental version identifier.

The software update request fromis thea serverJSON looks403 response like 403 JSON response with next body:this:

{
    "code": "com.apple.softwareupdate.required",
    "details": {"OSVersion": <minimum OS version> }
}

In this case enrollmentEnrollment is interrupted by the Apple dialogs mentionedshown above.above until the device meets the requirement.