When macOS hangs on the Apple logo and progress bar following a system update, the bootloader (boot.efi) has stalled while verifying the cryptographically Signed System Volume (SSV), reconciling an incomplete auxiliary kernel extension collection, or attempting to write swap memory to an internal SSD exhausted of free storage. Whether the bar freezes at 100%, stalls midway, or reboots into an infinite loop, resolving the boot halt requires determining whether the operating system is hung on a filesystem seal, a hardware handshake, or damaged staging cache.

Quick Diagnostic Matrix

1. Verify Real-Time Freeze vs. Background APFS Migration

1. Perform the Caps Lock Test: Tap the Caps Lock key on the built-in keyboard.
   • If the green LED fails to illuminate, the macOS kernel has panicked or the hardware bus is completely deadlocked. You must proceed with a hard reboot.

   • If the green LED toggles on and off normally, the CPU is actively processing background tasks, but the display server has not drawn the next percentage tick. Wait an additional 20 minutes.

2. Disconnect all peripherals: Unplug Thunderbolt docks, external drives, display adapters, and USB hubs. A hung handshake from an external mass-storage device can stall the bootloader indefinitely while it queries connected volumes.

3. Force a power cycle: Press and hold the Power button (or Touch ID sensor) for 10 seconds until the screen cuts to complete black. Leave the power cord connected, wait 15 seconds, and power on.

2. Boot into Safe Mode to Bypass Problematic Kexts

On Apple Silicon (M1, M2, M3, M4):

1. Shut down the Mac completely.

2. Press and hold the Power button. Continue holding it through the initial chime until the screen reads “Loading startup options”.

3. Highlight your main boot volume (usually Macintosh HD).

4. Press and hold the Shift key, then click Continue in Safe Mode.

5. Release the Shift key. The Mac will boot with “Safe Boot” visible in red in the top-right menu bar.

[Apple Silicon: Powered Off] 
 └── Hold Power Button Until "Loading startup options"
      └── Select Macintosh HD > Hold Shift > "Continue in Safe Mode"

On Intel Macs:

1. Turn on the Mac and immediately press and hold the Shift key.

2. Release Shift as soon as the Apple logo and progress bar appear.

3. If the Mac loads into the desktop successfully, restart the machine normally from  > Restart. The clean rebuild of the kernel cache performed during Safe Mode often resolves the regular boot hang.

3. Run Disk Utility First Aid in Recovery Mode

1. Access macOS Recovery:
   • Apple Silicon: Hold the Power button from a powered-off state until startup options appear, select Options, and click Continue.

   • Intel: Power on and immediately hold Command (⌘) + R until the spinning globe or Apple logo appears.

2. Select Disk Utility and click Continue.

3. In the top toolbar, click View > Show All Devices.

4. Run First Aid in strict hierarchical order from top to bottom:
   1. The physical drive name (e.g., APPLE SSD AP0512M).

   2. The APFS Container (e.g., Container disk1).

   3. The System Volume (Macintosh HD).

   4. The Data Volume (Macintosh HD – Data).

5. If First Aid returns “File system check exit code is 0”, the drive structure is healthy. If it reports an uncorrectable error, you must reinstall macOS.

4. Purge Broken Update Directories via Terminal

1. In macOS Recovery, go to the top menu bar and select Utilities > Terminal.

2. Run the disk space utility to ensure the internal drive is not at 100% capacity:
   Bash

   df -h
   

   (If the Macintosh HD - Data mount shows 0 bytes available, the operating system cannot allocate swap files to boot).

3. Mount the target storage volume if it is encrypted with FileVault:
   Bash

   diskutil apfs unlockVolume /dev/disk1s1
   

   (Enter your FileVault user password when prompted).

4. Check for and remove corrupted installer staging files:
   Bash

   cd "/Volumes/Macintosh HD"
   ls -la
   

5. If macOS Install Data is present, delete it to force the bootloader back to the standard macOS kernel:
   Bash

   rm -rf "macOS Install Data"
   

6. Type reboot and hit Enter.

5. Purge Stale NVRAM and SMC Registers (Intel Only)

1. Reset NVRAM: Power on the Mac and immediately press and hold Option + Command + P + R. Hold all four keys for a full 20 seconds. Release when you hear the startup chime twice or see the screen illuminate a second time.

2. Reset the SMC (System Management Controller):
   • MacBooks with T2 Security Chip: Shut down. Hold Control (left) + Option (left) + Shift (right) for 7 seconds, then hold the Power button alongside them for another 7 seconds. Release all keys, wait 5 seconds, and power on.

   • Desktop Macs (iMac, Mac mini, Mac Studio): Unplug the power cord from the wall. Wait 15 seconds. Plug the cord back in, wait 5 seconds, and press the power button.

6. Reinstall macOS (Overwrites System Without Losing Data)

1. Boot into macOS Recovery (Hold Power on Apple Silicon; hold Command + R on Intel).

2. Select Reinstall macOS [Version Name] from the main utilities window and click Continue.

3. Agree to the terms and select Macintosh HD as the destination disk (never select an external drive or a separate partition).

4. Click Install.