
Resolve issues during Mac setup
Setup Assistant can encounter issues during Mac activation and configuration. Supporting users through Setup Assistant issues helps maintain productivity by resolving activation, enrollment, and configuration barriers that prevent access to organizational resources and apps.
Device enrollment fails
Setup Assistant should display the Remote Management screen showing “Your organization is managing this Mac” during the enrollment process. When device management enrollment fails, users can’t access organizational apps, settings, and security configurations.
What to look for:
Remote Management screen doesn’t appear.
“Enrolling with management service failed. Retry.” message appears.
Mac can’t contact the device management service.
Steps to take:
Verify network connectivity by connecting to a reliable Wi-Fi or Ethernet network with open access.
In Apple School Manager or Apple Business, confirm that the Mac is assigned to the correct device management service.
Check the Mac serial number with your device management service administrator to confirm it appears in Apple School Manager or Apple Business prior to enrollment.
Use the Mac Evaluation Utility to confirm access to required ports and Apple servers (requires access to AppleSeed for IT).
Review Use Apple products on enterprise networks for access to additional required Apple servers.
Note: If the enrollment profile isn’t pushed or fails to install, the Mac won’t be enrolled in device management and will behave like an unmanaged Mac. If this happens, contact your device management service administrator.
Wi-Fi configuration issues
After selecting Language and Region, Setup Assistant prompts for Wi-Fi network selection. Without Wi-Fi connectivity, the Mac may skip Remote Management enrollment entirely, preventing device management configuration.
What to look for:
The Wi-Fi Network prompt appears after choosing Language and Region.
The Mac skips Remote Management when no Wi-Fi is connected.
Setup process halts without network configuration.
Steps to take:
Select available Wi-Fi network from the list of detected networks.
If Wi-Fi isn’t preconfigured through device management, contact the device management administrator.
Use Ethernet connection as alternative if Wi-Fi configuration fails.
Verify network credentials if connecting to secured Wi-Fi networks.
The network is blocking access to Apple servers
Important: The Mac needs to contact Apple activation servers to verify device management assignment. Network restrictions can prevent access to required Apple URLs and services.
What to look for:
“Enrolling with management service failed. Retry.” message.
“Could not contact the management service.” message.
The Mac can’t reach
deviceenrollment.apple.comormdmenrollment.apple.com.Steps to take:
Check the Apple System Status page for current outages or maintenance.
Use the Mac Evaluation Utility to confirm access to required ports and Apple servers (requires access to AppleSeed for IT).
Review network configuration with your network administrator to ensure access to required ports and URLs.
Review Use Apple products on enterprise networks for access to additional required Apple servers.
Device management apps don’t install
Setup Assistant may display the “Setting up your Mac” screen while it installs apps from the device management service. Missing apps during setup indicate configuration or licensing issues.
What to look for:
“Setting up your Mac” screen appears during setup.
Apps are missing without error messages.
Setup screen displays for extended time before timing out.
Steps to take:
Review device management logs in your organization’s device management portal.
Verify app licenses in the device management service for sufficient Apps and Books content licenses.
Check app assignments to confirm the app profile is assigned to the specific device.
Wait for background installation as some apps may install after initial setup completes.
Apple Account sign-in fails
Users may encounter issues signing in with unmanaged (personal) Apple Accounts during Setup Assistant, preventing access to iCloud services and App Store.
For more information, see the Apple Support articles If you can’t connect or sign in to iCloud and If your Apple Account is locked, not active, or disabled.
What to look for:
Unable to sign in with unmanaged Apple Account credentials.
Error messages during account creation or sign-in process.
Account verification or authentication failures.
Steps to take:
Check the Apple System Status page to make sure that there are no outages or scheduled maintenance currently affecting Apple Accounts or iCloud.
Verify internet connection stability and reliability.
Test account credentials by signing in at account.apple.com.
Skip account setup and configure the Apple Account later in System Settings.
For persistent Apple Account issues, see the Apple Support articles If you can’t connect or sign in to iCloud and If your Apple Account is locked, not active, or disabled.
Activation Lock prevents setup
After a Mac is erased, it contacts Apple during activation to check for Activation Lock status. Two types of Activation Lock can protect devices from unauthorized use.
What to look for:
Activation Lock screen appears on “Activating Mac” screen after device erase.
Setup process stops at activation verification step.
What’s happening:
User-linked Activation Lock turns on automatically when users turn on Find My. Apple stores the Apple Account credentials on activation servers and links them to the device.
Organization-linked Activation Lock can be turned on by a device management service for a Mac enrolled with Automated Device Enrollment. Device management service administrators can clear it with the bypass code or the Managed Apple Account credentials.
Steps to take:
Enter Apple Account credentials for user-linked Activation Lock using the unmanaged Apple Account that turned on Find My.
Use the bypass code for organization-linked Activation Lock from your device management service, or enter the Managed Apple Account credentials used to link the service to Apple School Manager or Apple Business.
Ask the person in your organization with Manage Devices privileges to turn off Activation Lock for the device in Apple School Manager or Apple Business.
Submit support request with proof-of-ownership documentation including serial number, IMEI, or MEID. Contact Apple Support to initiate an Activation Lock support request for devices you own.
Note: To prevent Activation Lock issues, ask users to sign out of unmanaged Apple Accounts before erasing devices. On supervised devices, use a device management service to prevent users from turning on user-linked Activation Lock.
Recover from paired recoveryOS
When a Mac encounters setup issues that require system recovery, macOS Recovery performs a local installation using the recovery system paired with the current macOS version. Recovery doesn’t install from the internet but uses the version of macOS Recovery that’s already on the device.
What to look for:
Setup Assistant fails to complete after multiple attempts.
macOS appears to need recovery or reinstallation.
The Mac starts up to macOS Recovery automatically.
Steps to take:
Restart in macOS Recovery by pressing and holding the power button until you see startup options, then click Options.
Use the paired recoveryOS, which contains the recovery macOS version that matches the installed version.
Reinstall macOS using the local recovery system without internet download.
Contact the device management service administrator if recovery issues persist with managed devices.