Fix 'macOS cannot be installed on Macintosh HD' Error

Symptoms

When attempting to install or upgrade macOS, you see the error message: "macOS cannot be installed on Macintosh HD". The installation may stop early, or the disk appears grayed out in the installer. Other symptoms include:

• Installation progress bar freezes or fails.
• Disk Utility shows Macintosh HD with a red exclamation mark.
• System reports "This disk is not eligible for this version of macOS."
• You cannot select Macintosh HD as the destination disk.

Root Causes

This error typically arises from one or more of the following:

• Disk corruption: File system errors or directory damage prevent writing.
• Incompatible disk format: The disk is formatted as Mac OS Extended (HFS+) instead of APFS (required for modern macOS).
• Insufficient free space: Less than 20 GB available for installation.
• Firmware or partition issues: Damaged GUID partition map or EFI partition.
• Third-party software interference: Antivirus or system utilities blocking disk access.

Step-by-Step Fix

1. Boot into macOS Recovery

1. Restart your Mac and immediately hold Command (⌘) + R until the Apple logo or spinning globe appears.
2. Select your language if prompted.

2. Run First Aid on the Startup Disk

1. In macOS Recovery, open Disk Utility from the Utilities menu.
2. Select Macintosh HD (the physical disk, not the container) from the left sidebar.
3. Click First Aid and then Run. Wait for the process to complete.
4. If errors are found, Disk Utility will attempt repairs. Repeat until no errors remain.

3. Erase the Disk (if First Aid fails)

If the disk remains problematic, you may need to erase it. Warning: This deletes all data. Ensure you have a backup.

1. In Disk Utility, select Macintosh HD (the top-level physical disk).
2. Click Erase.
3. Set Name to Macintosh HD.
4. Set Format to APFS (or Mac OS Extended (Journaled) for older macOS versions).
5. Set Scheme to GUID Partition Map.
6. Click Erase. The disk will be reformatted.

4. Reinstall macOS

1. Quit Disk Utility to return to the main recovery window.
2. Select Reinstall macOS (or Reinstall macOS [version]).
3. Follow the on-screen instructions, choose Macintosh HD as the destination.
4. Allow the download and installation to complete. Your Mac may restart multiple times.

Alternative Fixes

Check Disk Space

If you cannot erase the disk, boot into Recovery and use Terminal to check space:

diskutil list

Then check free space on Macintosh HD. If less than 20 GB, free up space by deleting files from Recovery using rm commands (advanced) or boot from an external drive.

Use Internet Recovery

If standard Recovery fails, hold Option + Command + R at startup to use Internet Recovery. This downloads the latest compatible macOS and may resolve firmware issues.

Reset NVRAM/PRAM and SMC

• Intel Macs: Restart and hold Option + Command + P + R for 20 seconds. For SMC, follow model-specific steps.
• Apple Silicon (M1/M2): NVRAM reset is automatic; just shut down and restart.

Prevention

• Regular backups: Use Time Machine to avoid data loss before major updates.
• Maintain free space: Keep at least 20-30 GB free on your startup disk.
• Update macOS gradually: Avoid skipping major versions; install incremental updates.
• Run Disk Utility First Aid monthly: Check disk health proactively.
• Avoid force quitting installers: Interrupting macOS installation can corrupt the disk.

By following these steps, you should be able to resolve the "macOS cannot be installed on Macintosh HD" error and successfully install macOS. If problems persist, consider contacting Apple Support or visiting an Apple Store.