Troubleshooting
For problems with the Oneleet Agent itself, see the agent troubleshooting page.
The Configuration Profiles tab is disabled
Section titled “The Configuration Profiles tab is disabled”Oneleet MDM isn’t turned on for your workspace. See Turn on Oneleet MDM.
Someone can’t find Download MDM profile
Section titled “Someone can’t find Download MDM profile”The Oneleet Portal offers the profile only while your Apple push certificate is valid, so check the Apple MDM Setup tab first. The button is in the top right of the portal’s Devices page, and appears once the person has connected a device. Before that, they click Install Oneleet Agent and find it under Apple MDM profile.
If the Mac runs Oneleet Agent 2.6.0 or later, you can skip the download. Open the Mac and choose Manage device > Prompt user to enroll in MDM.
A Mac has the profile but isn’t Managed
Section titled “A Mac has the profile but isn’t Managed”Downloading the profile doesn’t enroll the Mac. Someone has to approve it in System Settings > General > Device Management. See Install the profile.
If the Mac shows Other MDM, another product manages it. See Move from another MDM.
A Mac that was Managed no longer is
Section titled “A Mac that was Managed no longer is”Someone removed the enrollment profile, or the Mac was erased. See When a profile is removed.
The agent didn’t install after a Mac enrolled
Section titled “The agent didn’t install after a Mac enrolled”Oneleet retries the installation by itself until the agent connects. To follow the attempts, filter the Mac’s Activity tab for Agent install retry started. If the Mac is offline, it gets the agent when it’s back online.
A command stays Pending
Section titled “A command stays Pending”The device is usually offline, and the command is delivered when it reconnects. See Command statuses.
A menu item is disabled
Section titled “A menu item is disabled”Hover over it to see why. The usual reasons:
- The Mac isn’t enrolled. A Mac with only the agent can’t be locked, wiped, or restarted. Enroll it.
- The device is excluded from MDM. Change its MDM enrollment.
- The agent is out of date. See Version requirements.
- A command of the same kind is already pending.
A Windows setting keeps changing back
Section titled “A Windows setting keeps changing back”Something else on the device sets the same value, usually Group Policy on a domain-joined device or another MDM. On a domain-joined device, the page shows how many Group Policy objects apply under Active Directory. Hover over the count to see them. Set the same value in both places, or manage that setting in only one of them.
A recovery key isn’t saved
Section titled “A recovery key isn’t saved”- FileVault: FileVault was on before the Mac enrolled. Rotate the key on the Mac.
- BitLocker: the device needs Oneleet Agent 2.6.0 or later, Windows Pro, Enterprise, or Education, and a TPM.
A Mac doesn’t appear on the ADE Devices tab
Section titled “A Mac doesn’t appear on the ADE Devices tab”Check that it’s assigned to Oneleet’s service in Apple Business, then click Sync now. See Enroll Macs with Apple Business Manager.
An Apple credential expired
Section titled “An Apple credential expired”If the push certificate expires, Oneleet can’t reach any of your Macs. If the Apple Business service token expires, Oneleet can’t sync your inventory. Renew the existing credential. Don’t create a new one. See Renew the push certificate and Renew the service token.