Search guides

Fix a Mac that will not update

We'll check storage, network, and update settings, then isolate the cause—full disk, network issue, or corrupted cache—or tell you when to call a pro.

Troubleshooting · Home maintenance
15–60 min
What you'll need
  • Stable internet connection
  • At least 15–20 GB free space
Step 1 of 5

Quick triage — pick your path

Get started

Choose the option that matches what you see. You can jump straight to that section.

Show full guide

Steps

Goal: Rule out storage and network, then clear cache and retry.

Check storage

Goal: Confirm enough free space for the update.

  • Apple menu, About This Mac, Storage. Confirm at least 15–20 GB free. Delete large files, empty Trash, use Optimize Storage if needed.
  • Good: Enough space. Proceed to Clear update cache if the update still fails.
  • Bad: Free more space. Updates need room to download and expand.

Clear update cache

Goal: Remove corrupted or stuck update data.

  • Terminal: sudo softwareupdate —clear-catalog. Restart. System Settings, General, Software Update. Try the update again.
  • Good: Update downloads and installs. Proceed to Verification.
  • Bad: Download the full installer from Apple or use Recovery (Command+R at boot).

When to get help

Call Apple or a technician if:

  • The update fails repeatedly after freeing space and clearing cache.
  • The Mac will not boot after an update.
  • Recovery or reinstall is needed.

Verification

  • macOS is up to date in System Settings, General, Software Update.
  • The Mac restarts and runs the new version.
  • No update errors or stalls.

Escalation ladder

Work from the device outward. Stop when the problem is fixed.

  1. Storage and network Free 15–20 GB; connect to stable network.
  2. Quit apps and retry Quit heavy apps; try update again.
  3. Clear cache Delete update cache; restart; retry.
  4. Call a pro Update fails repeatedly; Recovery or reinstall needed.

What to capture if you need help

Before calling support or posting for help, have these ready. It speeds everything up.

  • Mac model and macOS version:
  • Free space on startup disk:
  • Error message (if any):
  • Steps already tried:

Do you have at least 15 GB free on the startup disk?

Updates need space to download and install.

Apple menu, About This Mac, Storage. Good: 15+ GB free—check network. Bad: free space first (delete files, empty Trash, Optimize Storage).

Yes No

You can change your answer later.

Free space

Delete large files, empty Trash, use Optimize Storage. See Fix a Mac that has storage full. Retry the update.

Done

Is the network stable?

Large downloads need a stable connection.

Use Wi‑Fi or Ethernet. Avoid public networks. Quit heavy apps. Good: stable—clear cache and retry. Bad: switch network or wait for better connection.

Yes No

You can change your answer later.

Clear update cache and retry

Terminal: sudo softwareupdate --clear-catalog. Restart. System Settings, Software Update. Try again. If still fails, download full installer from Apple or use Recovery.

Done

Update installed

The Mac is up to date. You are done.

Done

Reviewed by Blackbox Atlas

Frequently asked questions

Why would a Mac not update?
Not enough free space, network issue, corrupted update cache, or incompatible software. Check storage and network first.
Can I fix a Mac that will not update myself?
Yes. Free at least 15–20 GB, check network, delete update cache, try again. If the update repeatedly fails, use Recovery or a technician may be needed.
When should I call a technician for Mac updates?
If the update fails repeatedly after freeing space and clearing cache, or the Mac will not boot after an update. Recovery mode or reinstall may be needed.

Rate this guide

Was this helpful?

Continue to