macOS update error 102 usually means the update could not be downloaded, verified, prepared, or installed successfully. The cause may be a temporary Apple server problem, an incomplete installer download, insufficient storage, an incompatible Mac, a network issue, or software that interferes with the update process.
Start by restarting your Mac and checking your internet connection. If the error returns, free up storage, remove the failed update download, install any available compatibility updates, and try the update again in Safe Mode. The steps below move from the safest and simplest fixes to more advanced options.
Quick Answer
To fix macOS update error 102:
- Restart your Mac and try the update again. 2. Confirm that your Mac is connected to a reliable network. 3. Check available storage and make room if necessary. 4. Delete the incomplete macOS update download. 5. Check whether your Mac supports the update. 6.
What Causes macOS Update Error 102?
Error 102 does not always identify one specific problem. It can appear when macOS cannot complete one of several stages in the update process, including:
- Downloading the update from Apple’s servers
- Verifying the installer
- Preparing the update
- Writing update files to the startup disk
- Restarting and completing installation
- Communicating correctly with Apple’s update services
Common causes include:
- A temporary internet or server connection problem
- A corrupted or incomplete update package
- Too little free storage
- An unsupported Mac
- An outdated version of macOS or related system software
- VPN, firewall, antivirus, or network-filtering software
- Disk errors or damaged system files
- An interrupted previous update
The error can therefore require more than one fix. Try each relevant method in order, and test the update after each major change.
1. Restart Your Mac and Retry the Update
A restart clears temporary system processes and can remove a minor software or network glitch.
- Save your work and close open apps.
- Select the Apple menu in the upper-left corner.
- Choose Restart.
- After your Mac starts again, open System Settings.
- Select General, then Software Update.
- Try downloading and installing the update again.
On older versions of macOS, open System Preferences and select Software Update instead.
If the update failed while your Mac was restarting or installing, allow the computer several minutes to finish starting. Do not repeatedly force it to shut down while an update is in progress unless the Mac is completely unresponsive.
2. Check Your Internet Connection
A weak or interrupted connection can prevent macOS from downloading or verifying the update.
Try these steps:
- Open System Settings and select Wi-Fi.
- Confirm that you are connected to the correct network.
- Move closer to the router or connect to a different reliable network.
- If possible, test the update using a wired Ethernet connection.
- Temporarily disconnect from a VPN.
Avoid updating over a network that requires a browser sign-in, such as some hotel, airport, school, or workplace networks. These connections may interrupt large downloads or block Apple services.
You can also restart your router, but warn anyone using the network first because this temporarily disconnects all connected devices.
If the update works on another network, the original network may be blocking or interrupting the download. In that case, ask the network administrator whether software-update traffic is restricted.
3. Check Free Storage
macOS needs space for the downloaded installer, temporary files, and the installed system. The amount required varies by update and Mac, so do not rely only on the size shown for the download.
To check storage:
- Select the Apple menu.
- Choose System Settings.
- Select General, then Storage.
- Review the recommendations and categories shown.
On older macOS versions, choose About This Mac from the Apple menu, then select Storage.
Remove or move large files you no longer need. Common space users include:
- Downloads
- Old iPhone or iPad backups
- Large videos
- Unused applications
- Files in the Trash
- Old disk images and installer files
Emptying the Trash permanently removes its contents, so review it carefully first. If you need more guidance, see How to Fix “Not Enough Space” When Installing a macOS Update.
After freeing space, restart your Mac and try Software Update again.
4. Remove the Incomplete Update Download
A damaged or incomplete installer can cause macOS to fail at the same point each time. Removing the failed download lets Software Update obtain a fresh copy.
The exact location can vary by macOS version. The safest approach is to use Apple’s built-in storage recommendations first and remove any clearly identified failed installer. If you are comfortable using Finder, check the Applications folder for a macOS installer app whose name begins with Install macOS. Move only the installer associated with the failed update to the Trash.
Do not delete an installer if you still need it for another Mac or if you are unsure whether it is the correct file. Emptying the Trash will permanently remove it.
After removing the failed installer:
- Restart your Mac.
- Open System Settings.
- Select General, then Software Update.
- Download the update again.
For more detailed cleanup steps, see How to Remove a Failed macOS Update Download.
5. Check Whether Your Mac Supports the Update
An update may fail if the Mac does not meet its hardware requirements. This is especially important when installing a major macOS release rather than a smaller security or system update.
To identify your Mac:
- Select the Apple menu.
- Choose About This Mac.
- Note the model name, model year, and chip or processor information.
Then compare that information with Apple’s requirements for the macOS release you are trying to install. If the update is not offered in Software Update, your Mac may not support it, or the update may not be available for your model.
Do not use unofficial tools to force an unsupported macOS version onto a Mac unless you fully understand the risks. Unsupported installations can cause problems with drivers, security updates, performance, recovery, or future upgrades.
For a preparation checklist, see How to Check Mac Compatibility Before Installing a macOS Update.
6. Install Available Smaller Updates First
If your Mac is several updates behind, install any available minor update before attempting a larger upgrade. A smaller update may include system components required by the newer release.
- Open System Settings.
- Select General, then Software Update.
- Install the update currently offered.
- Restart the Mac if prompted.
- Return to Software Update and check again.
Keep the Mac connected to power during the process, especially on a Mac notebook. Do not close the lid, disconnect the charger, or shut down the computer while the installer is working.
7. Try the Update in Safe Mode
Safe Mode starts macOS with only essential components. It can help determine whether a login item, third-party extension, security utility, or other background software is interfering with the update.
Before starting, save your work. Safe Mode may close apps during the restart.
Apple silicon Mac
- Select the Apple menu, then choose Shut Down.
- Press and hold the power button until Loading startup options appears.
- Select a startup volume.
- Hold the Shift key and choose Continue in Safe Mode.
- Sign in.
- Open System Settings > General > Software Update and try the update.
Intel-based Mac
- Select the Apple menu, then choose Restart.
- Immediately press and hold the Shift key.
- Release the key when the login window appears.
- Sign in. You may need to sign in a second time.
- Open Software Update and try again.
If the update succeeds in Safe Mode, a third-party startup item or background utility may be responsible. Restart normally and temporarily disable nonessential login items, VPN software, antivirus tools, and system-cleaning utilities before trying again.
8. Temporarily Remove Software That May Interfere
Some security, VPN, firewall, and network-filtering applications can interfere with downloads or system verification. Rather than deleting these apps immediately, quit them or use their built-in pause or disable option first.
Before changing security settings, note how to restore them. Do not leave your Mac without protection longer than necessary, and reconnect to a trusted network.
After disabling the software:
- Restart the Mac.
- Try the update.
- Re-enable the software if the update fails for an unrelated reason or after installation completes.
If the update works only when a particular utility is disabled, check that app for updates or contact its developer for compatibility information.
9. Check the Startup Disk with Disk Utility
Disk errors can prevent macOS from writing update files correctly. Disk Utility’s First Aid feature checks the volume structure and repairs certain problems.
Back up your Mac first. Although First Aid is designed to check and repair disk structures, important files should always be backed up before disk maintenance.
- Open Applications.
- Open Utilities.
- Launch Disk Utility.
- Select View > Show All Devices.
- In the sidebar, select the startup volume.
- Click First Aid, then choose Run.
- Repeat First Aid for relevant volumes if Disk Utility presents them separately.
Do not erase, partition, or format the disk. Those actions can delete data. If First Aid reports that it cannot repair the disk, stop troubleshooting the update and arrange a backup or professional service before attempting more repairs.
10. Use macOS Recovery if Normal Updating Fails
macOS Recovery provides tools for repairing the startup disk and reinstalling macOS. Reinstalling macOS from Recovery is more advanced and should be considered only after backing up important files.
To enter Recovery:
- Apple silicon Mac: Shut down the Mac, then press and hold the power button until startup options appear. Choose Options, then Continue.
- Intel-based Mac: Restart the Mac and immediately hold Command-R until the Apple logo or a spinning globe appears.
In Recovery, open Disk Utility and run First Aid if you have not already done so. If you choose Reinstall macOS, read each screen carefully and select the existing system volume. Reinstalling macOS is intended to preserve personal files, but you should not treat it as a substitute for a backup.
If Recovery reports a disk failure, cannot find the startup disk, or repeatedly fails to reinstall macOS, contact Apple Support or an authorized service provider.
Troubleshooting
Error 102 appears immediately
Check the network, disconnect a VPN, restart the Mac, and try a different trusted connection. If the error remains, remove the incomplete installer and download it again.
The update downloads but fails during installation
Check available storage, run Disk Utility’s First Aid, and try the installation in Safe Mode. Also disconnect unnecessary external devices except the charger, keyboard, mouse, and display.
The update is stuck on “Preparing”
Give the Mac time if the progress indicator is still changing. Do not force a shutdown during active installation. If it remains unchanged for an unusually long period and the Mac is unresponsive, use Apple’s normal shutdown procedure only as a last resort. For targeted steps, see How to Fix macOS Update Stuck on Preparing.
Software Update shows no available update
Confirm that the Mac supports the release, restart the computer, and check again. A managed work or school Mac may also have updates controlled by an administrator.
The Mac will not start after the failed update
Disconnect nonessential external devices and try starting again. If the Mac reaches the login screen, back up your files immediately. If it shows a flashing question mark, repeated restart loop, recovery screen, or disk error, enter macOS Recovery and run Disk Utility’s First Aid. Do not erase the startup disk unless you have a verified backup and understand that erasing deletes its contents.
Frequently Asked Questions
Is macOS update error 102 serious?
Not necessarily. It often results from a failed download, insufficient storage, or a temporary connection problem. It becomes more serious if the Mac cannot start, the startup disk reports errors, or Recovery cannot repair or reinstall macOS.
Will fixing error 102 delete my files?
The basic steps—restarting, checking storage, changing networks, removing an incomplete installer, and using Safe Mode—should not delete personal files. Moving an installer to the Trash removes that installer, not your documents. Always back up before using Disk Utility or Recovery.
Should I keep retrying the update?
Retrying repeatedly without changing anything is unlikely to help. Restart the Mac, check the network and storage, remove the failed download, and then try again. If the error persists, use Safe Mode or Disk Utility.
Can I update macOS without Wi-Fi?
Yes. You can use Ethernet or another reliable internet connection. A wired connection can be more stable for a large installer.
When should I contact Apple Support?
Contact Apple Support if the Mac cannot start normally, Disk Utility reports an unrepairable disk, the Mac is compatible but every update attempt fails, or Recovery cannot reinstall macOS. Have the Mac model, macOS version, and exact error message available.
Final Thoughts
macOS update error 102 is usually resolved by correcting the condition that interrupted the update.