How to troubleshoot and fix macOS software update errors
Summary
This guide helps you troubleshoot and resolve: How to troubleshoot and fix macOS software update errors. Follow the steps below to fix the issue.
Common Causes
Keeping your macOS version up to date is critical for the security and stability of your business operations. However, it is not uncommon for updates to hang, fail to download, or return an error message. This guide will walk you through the process of diagnosing and resolving these installation failures for modern macOS versions, including Ventura, Sonoma, and Sequoia.
Before you begin
If your Mac is managed by your IT provider or enrolled in a Mobile Device Management (MDM) solution, updates may be deferred or blocked by organisational policy. In these cases, please Open a Ticket rather than attempting manual overrides, as this may conflict with company security settings.
Important: Always ensure you have a current backup of your data via Time Machine or another cloud backup service before attempting a macOS reinstall or major system update.
Quick Fix Steps
Before attempting more complex technical solutions, try these basic steps which resolve the majority of update errors:
- Check your internet connection: Ensure you have a stable connection. If you are using a VPN, disconnect it, as these can often interfere with Apple's update servers.
- Restart your Mac: A simple reboot can clear temporary cache files that may be blocking the update process.
- Check Apple System Status: Visit the Apple System Status page to ensure that macOS Software Update servers are online and not experiencing an outage.
- Verify admin privileges: You must be logged in as an administrator to install software updates. Go to System Settings > Users & Groups to confirm your account type.
Checking disk space
macOS updates typically require between 15GB and 35GB of free space to download and expand the installer. If your drive is nearly full, the update may fail or appear to hang.
- Click the Apple Menu in the top-left corner of your screen.
- Select System Settings.
- Navigate to General > Storage.
- Review the storage bar and identify large files or applications that can be removed.
- Empty the Trash and restart your Mac before attempting the update again.
Updating via System Settings
The standard way to update is through the built-in software update tool. If it has failed, try triggering it again manually:
- Click the Apple Menu in the top-left corner of your screen.
- Select System Settings.
- Navigate to General > Software Update.
- Wait for the system to check for updates. If an update is available, click Update Now or Upgrade Now.
- If prompted, enter your administrator password and agree to the terms and conditions.
Booting into Safe Mode
Third-party security software, such as CrowdStrike, SentinelOne, or Jamf, can sometimes block the installation of system files. Safe Mode disables these extensions and allows you to test if a third-party programme is causing the failure.
Apple Silicon (M1, M2, M3)
- Shut down your Mac completely.
- Press and hold the Power button until you see "Loading startup options".
- Select your startup disk.
- Hold the
Shiftkey and click Continue in Safe Mode. - Log in to your Mac and attempt the update via System Settings > General > Software Update.
Intel-based Macs
- Shut down your Mac completely.
- Turn on the Mac and immediately press and hold the
Shiftkey. - Release the key when you see the login window.
- Log in and attempt the update via System Settings > General > Software Update.
Resetting NVRAM and SMC (Intel Macs only)
If you are using an Intel-based Mac, resetting the NVRAM/PRAM or System Management Controller (SMC) can resolve update-related issues caused by corrupted system settings.
Reset NVRAM/PRAM
- Shut down your Mac.
- Turn it on and immediately press and hold
Option (⌥) + Command (⌘) + P + R. - Hold the keys for about 20 seconds, then release.
- Allow your Mac to restart normally.
Reset SMC (MacBook with T2 chip)
- Shut down your Mac.
- Press and hold
Control (⌃) + Option (⌥) + Shift (⇧)on the left side of the keyboard and the Power button for 7 seconds. - Release all keys and wait a few seconds.
- Press the Power button to turn on your Mac.
Using macOS Recovery Mode
If the update fails to install while the operating system is running, you can attempt to reinstall macOS from the Recovery partition. This replaces the system files with a fresh, updated version.
- Shut down your Mac completely.
- For Apple Silicon (M1, M2, M3): Press and hold the Power button until you see "Loading startup options". Click Options, then click Continue.
- For Intel Macs: Turn on the Mac and immediately press and hold
Command (⌘) + Runtil the Apple logo appears. - Select Reinstall macOS from the Utilities window and follow the on-screen prompts.
Common error messages and solutions
| Error message | Likely cause | Suggested solution |
|---|---|---|
| Unable to verify update | Incorrect date and time settings or network interference. | Check System Settings > General > Date & Time and ensure "Set time and date automatically" is enabled. Disconnect any VPN. |
| An error occurred preparing the update | Insufficient disk space or corrupted download files. | Free up at least 35GB of space via System Settings > General > Storage, restart, and try again. |
| Update requested | Update is pending but not yet downloading. | Wait 15–30 minutes. If it persists, restart your Mac and check System Settings > General > Software Update again. |
| Not enough space | Storage is critically low or system cache is reporting incorrectly. | Delete unnecessary files, empty the Trash, and restart. If space is adequate, try updating via Recovery Mode. |
If you have followed these steps and the update still fails, please Open a Ticket so our technicians can analyse your system logs.
Still Having Issues?
💻 Open a Ticket