Home › Knowledgebase › KB-155

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.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

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:

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.

  1. Click the Apple Menu in the top-left corner of your screen.
  2. Select System Settings.
  3. Navigate to General > Storage.
  4. Review the storage bar and identify large files or applications that can be removed.
  5. 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:

  1. Click the Apple Menu in the top-left corner of your screen.
  2. Select System Settings.
  3. Navigate to General > Software Update.
  4. Wait for the system to check for updates. If an update is available, click Update Now or Upgrade Now.
  5. 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)

  1. Shut down your Mac completely.
  2. Press and hold the Power button until you see "Loading startup options".
  3. Select your startup disk.
  4. Hold the Shift key and click Continue in Safe Mode.
  5. Log in to your Mac and attempt the update via System Settings > General > Software Update.

Intel-based Macs

  1. Shut down your Mac completely.
  2. Turn on the Mac and immediately press and hold the Shift key.
  3. Release the key when you see the login window.
  4. 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

  1. Shut down your Mac.
  2. Turn it on and immediately press and hold Option (⌥) + Command (⌘) + P + R.
  3. Hold the keys for about 20 seconds, then release.
  4. Allow your Mac to restart normally.

Reset SMC (MacBook with T2 chip)

  1. Shut down your Mac.
  2. Press and hold Control (⌃) + Option (⌥) + Shift (⇧) on the left side of the keyboard and the Power button for 7 seconds.
  3. Release all keys and wait a few seconds.
  4. 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.

Warning: While reinstalling macOS via Recovery Mode typically preserves your data, you must ensure you have a current backup via Time Machine before proceeding.
  1. Shut down your Mac completely.
  2. For Apple Silicon (M1, M2, M3): Press and hold the Power button until you see "Loading startup options". Click Options, then click Continue.
  3. For Intel Macs: Turn on the Mac and immediately press and hold Command (⌘) + R until the Apple logo appears.
  4. 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?

Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.

💻 Open a Ticket