macOS Machine Crashing / Hanging — Diagnosis and Reinstall Workflow

Section: macOS & Apple Hardware Tags: macos, crashing, hanging, spinning-wheel, freeze, reinstall, slow, performance Source tickets: #21824, #19544 Confidence: High — workflow confirmed across multiple clients

---

Symptom

Mac is consistently slow, freezing, showing the spinning beach ball, or crashing (kernel panic / unexpected restart). The issue persists after a normal reboot. Can affect any Mac — MacBook, iMac, Mac mini.

Variants include:

• Applications freezing individually (Outlook, Acrobat, Revit)
• Entire OS unresponsive requiring hard power-off
• Machine very slow to start up
• Frequent unexpected restarts

---

Root Cause

Multiple possible causes — diagnosis must rule them out in order:

• Storage full or near-full (most common, especially on older Macs with small HDDs)
• Hardware fault — failing HDD, bad RAM, overheating
• Corrupt macOS system files — often following an interrupted update
• Application-specific conflict — a specific app or plugin causing crashes
• Malware (less common on macOS but possible)

---

Prerequisites

• Physical or remote (TeamViewer) access to the Mac
• If hardware fault suspected: ability to arrange collection for bench work
• Client confirmation of any recent changes (OS update, new app install, physical move of machine)

---

Diagnosis Steps

Step 1 — Check storage

• Apple menu () → About This Mac → Storage
• If less than 10–15GB free on the startup disk: storage is the primary cause
• Run DaisyDisk (download from daisydiskapp.com) to identify what is consuming space
• Common culprits: large email downloads (Outlook caches), Downloads folder, old iOS backups, duplicate files

Step 2 — Check hardware

• Reboot and hold D at startup → run Apple Diagnostics (AHT)
• Note any error codes (e.g., ADP000 = no issue, MEM001x = RAM fault, HDD-001 = storage fault)
• Check CPU/memory pressure: open Activity Monitor → CPU and Memory tabs — look for red "Memory Pressure" or processes consuming >50% CPU constantly
• Check Mac age and storage type: pre-2017 iMacs with spinning HDD are the most common source of "slow" complaints — the HDD is simply too slow for modern macOS, not failing

Step 3 — Check for application-specific crashes

• Open Console.app → search for "crash" — look for repeated crash reports for a specific process
• Check System Preferences → Software Update — pending OS updates that were interrupted can cause instability
• For Outlook-specific hangs: disable hardware acceleration (Outlook → Preferences → General → Turn off hardware graphics acceleration)
• For Revit/CAD apps: check the vendor's known issues for the specific macOS version

---

Remediation Steps

Scenario A — Storage full (most common)

• Delete contents of ~/Downloads (confirm with user first)
• Empty Trash
• In Outlook: Outlook → Preferences → General → Compact Database
• Remove old iOS backups: Finder → [iPhone/iPad] → Manage Backups → Delete
• Move large files to an external drive or OneDrive/Google Drive
• Target: at least 15–20GB free

Expected result: Mac performance improves immediately once >10% of disk is free.

Scenario B — Application reinstall (app-specific crashes)

• Quit the app completely
• Download and run the app's official uninstaller (Acrobat, Office) or drag from Applications to Trash
• Reboot
• Reinstall from the vendor's site or the App Store
• Test for stability

Expected result: Fresh install clears corrupt preferences or broken extensions.

Scenario C — macOS reinstall (persistent system instability)

Recommended when hardware checks pass, storage is not the issue, and instability persists across multiple apps.

• Back up data: Time Machine → Back Up Now — confirm backup completes
• Reboot into Recovery: hold Cmd+R at startup
• Select Reinstall macOS — this reinstalls the OS without erasing user data
• Allow installation to complete (30–60 minutes)
• Test stability after reinstall

Risk: Caution — confirm Time Machine backup is current before proceeding. The reinstall preserves user data but a failed backup means data may be unrecoverable if something goes wrong.

Scenario D — Collect for bench work (hardware fault confirmed)

If Apple Diagnostics reports hardware errors, or the machine is unbootable:

• Confirm with the client that the machine needs to go to bench
• Check for any pending backup — if the machine cannot boot, advise client to bring any external Time Machine or CCC backup drives
• Log collection in the ticket with date and client contact
• At bench: run full Apple Diagnostics, check SMART status of storage (diskutil info /dev/disk0), test RAM
• For older iMacs (2015 and prior) with HDD: recommend SSD upgrade as a resolution — far more cost-effective than OS reinstall on a failing HDD
• For MacBook battery issues: check battery condition in About This Mac → System Report → Power → Cycle Count — replace if count > 1000 or condition shows "Service Recommended"

---

Verification

Run the machine for 30+ minutes under normal load. No spinning beach ball, no unexpected quits. Check Activity Monitor → Memory — memory pressure should be green. Run the app that was previously crashing and confirm stability.

---

If This Fails

If reinstalling macOS does not resolve the issue, the problem is hardware. Common hardware failures on older Macs:

• iMac 2011–2015: GPU failure (screen artefacts + crash), HDD failure
• MacBook Pro 2016–2019: keyboard issues, T2 chip firmware
• All models: RAM failure (intermittent random crashes)

Arrange Apple repair or third-party repair as appropriate.

---

Related

• Article: iMac HDD → SSD Upgrade — for storage-related performance on older iMacs
• Article: Time Machine Backup Failures to Synology NAS — if pre-repair backup is failing