What you will achieve

Stop the spinning pointer (beachball) when macOS apps hang or the whole system stalls.

The spinning wait cursor — beachball — signals an unresponsive main thread or system resource starvation. Single-app beachballs differ from system-wide freezes. Activity Monitor separates CPU hogs from memory pressure from disk I/O waits — diagnose category before rebooting blindly.

1) App vs system hang

Beachball in one app: force quit that app (⌘ + Option + Esc). Beachball everywhere: system under pressure.

2) Check pressure

Open Activity Monitor → CPU — sort by % CPU; quit runaway processes.
Memory tab — red or yellow memory pressure means swap thrashing; quit heavy apps or restart.
Disk tab — high written/read with low CPU suggests indexing or Time Machine.

3) Common culprits

Spotlight reindexing after macOS update — wait or add exclusions.
Cloud sync (iCloud Drive, Dropbox) on huge folders.
Failing external drive causing fsck delays — disconnect and test.
Intel app under Rosetta using excess RAM on Apple Silicon.

4) Safe Mode test

Boot Safe Mode — if beachball vanishes, a login item or kernel extension is suspect. Remove login items under General → Login Items.

5) When persistent

Run Disk Utility First Aid; check Console for repeated disk I/O errors; consider free space under 10 GB — macOS needs scratch space.

6) WindowServer and GPU

Beachball during Mission Control or external monitor swap may be WindowServer high CPU — disconnect monitor, reboot. macOS Sonoma+ external display bugs often fixed in dot releases — check Software Update.

7) Network drives

Finder beachball on Desktop with disconnected SMB share — eject greyed server in Finder sidebar or disable “Connected servers” on desktop. Auto-reconnect VPN before opening documents on corporate share.

8) When to escalate

Beachball within minutes of clean boot with green memory pressure suggests failing SSD — run First Aid, check SMART via third-party tool, back up immediately.

Verify

UI responsive under normal workload; Activity Monitor memory pressure green most of the time.

Additional troubleshooting notes

If steps above do not resolve the issue on the first attempt, reboot once, confirm System Settings → General → Software Update is current, and retry with a second administrator account to rule out profile or keychain corruption in your daily user. Document exact error text from Console.app with timestamp — vague “it still fails” without logs wastes support time. On Apple Silicon, re-test after full shutdown (not just restart) because firmware and Thunderbolt controllers reset only on cold boot. Intel Macs should repeat test in Safe Mode to bypass third-party login items. Before erase or keychain reset, verify Time Machine or clone backup completed — batch 3 guides assume Monterey/Ventura/Sonoma/Sequoia paths in System Settings; search Spotlight for renamed panes if your macOS version labels differ slightly.