macOS Troubleshooting & Software Issues
Comprehensive solutions for common software problems on your MacBook.
1. macOS Won't Update
Common Causes & Fixes:
- Not Enough Storage:
- Need 15-20GB free for major updates
- Delete files or move to external drive
- Empty Trash
- Check: Apple menu → About This Mac → Storage
- Download Issues:
- Restart Mac and try again
- Check internet connection stability
- Try different network (mobile hotspot)
- Delete partial download: ~/Library/Updates
- Installation Failed:
- Boot into Safe Mode (hold Shift at startup)
- Try update from Safe Mode
- Reset NVRAM: Command + Option + P + R at startup
- Try installing from Recovery Mode
2. Apps Crashing or Freezing
Force Quit Frozen App:
- Press Command + Option + Esc
- Select app from list
- Click Force Quit
Fix Persistent Crashes:
- Update the App:
- Check App Store for updates
- Or check app's website
- Delete App Preferences:
- Finder → Go → Go to Folder
- Type: ~/Library/Preferences
- Find app's .plist files and delete
- Restart app
- Reinstall App:
- Uninstall completely (use AppCleaner)
- Restart Mac
- Reinstall fresh copy
- Check Console Logs:
- Open Console app (Utilities)
- Look for error messages when app crashes
- Search error online for solutions
3. Mac Running Slow
Quick Fixes:
- Restart Your Mac (clears RAM)
- Check Activity Monitor:
- Applications → Utilities → Activity Monitor
- Click CPU tab
- Quit apps using >80% CPU
- Check Memory tab - if "Memory Pressure" is red, need more RAM or close apps
- Reduce Login Items:
- System Settings → General → Login Items
- Remove unnecessary startup apps
- Free Up Storage:
- Keep 15% free for best performance
- Use Storage Management tool
- Clear Caches:
- Finder → Go → Go to Folder
- ~/Library/Caches - delete contents
- /Library/Caches - delete contents (need admin)
💡 Pro Tip: Run Disk Utility First Aid monthly. Open Disk Utility, select your drive, click First Aid. This fixes file system errors that slow down your Mac.
4. Bluetooth Not Working
Troubleshooting Steps:
- Toggle Bluetooth off and on
- Restart Mac
- Reset Bluetooth module:
- Hold Shift + Option
- Click Bluetooth icon in menu bar
- Select "Reset the Bluetooth module"
- Restart Mac
- Delete Bluetooth .plist files:
- /Library/Preferences/com.apple.Bluetooth.plist
- Restart
- Reset SMC and NVRAM
5. Storage Full Warnings
Quick Space Savers:
- Empty Trash: Right-click Trash → Empty Trash
- Delete Downloads: Review ~/Downloads folder
- Remove Old iOS Backups:
- Finder → Preferences → Devices
- Delete old device backups
- Clear Browser Cache:
- Safari: Settings → Advanced → Show Develop menu → Develop → Empty Caches
- Chrome: Settings → Privacy → Clear browsing data
- Remove Duplicate Files:
- Use Finder → Search for duplicates
- Or use app like Gemini 2
- Uninstall Unused Apps:
- Drag from Applications to Trash
- Or use AppCleaner for complete removal
Storage Management Tool:
- Apple menu → About This Mac → Storage
- Click Manage
- Options:
- Store in iCloud: Moves Desktop/Documents to cloud
- Optimize Storage: Removes watched iTunes content
- Empty Trash Automatically: After 30 days
- Reduce Clutter: Review and delete large files
6. Safari Problems
Safari Slow or Crashing:
- Clear History & Cache:
- Safari → Settings → Privacy
- Click "Manage Website Data" → Remove All
- Safari → Clear History
- Disable Extensions:
- Safari → Settings → Extensions
- Uncheck all extensions
- Re-enable one by one to find problem
- Reset Safari:
- Close Safari
- Delete ~/Library/Safari/
- Restart Safari
7. Wi-Fi Connection Issues
Can't Connect to Wi-Fi:
- Turn Wi-Fi off and on
- Restart router and Mac
- Forget network and rejoin:
- System Settings → Wi-Fi
- Click (i) next to network
- Click "Forget This Network"
- Rejoin with password
- Renew DHCP Lease:
- System Settings → Network → Wi-Fi → Details
- TCP/IP tab
- Click "Renew DHCP Lease"
- Delete Wi-Fi preferences:
- /Library/Preferences/SystemConfiguration/com.apple.airport.preferences.plist
- Restart
- Reset SMC and NVRAM
8. Mail App Issues
Mail Not Receiving/Sending:
- Check Connection Settings:
- Mail → Settings → Accounts
- Select account → Server Settings
- Verify incoming/outgoing server info
- Rebuild Mailbox:
- Select mailbox in sidebar
- Mailbox menu → Rebuild
- Wait for completion
- Remove and Re-add Account:
- Mail → Settings → Accounts
- Select account → minus (-) button
- Add account again
9. iCloud Sync Problems
Files Not Syncing:
- Check iCloud status: Check Apple's system status page
- Sign out and back in:
- System Settings → Apple ID
- Sign Out (keep local copy of data)
- Restart
- Sign back in
- Check storage: System Settings → Apple ID → iCloud
- Disable and re-enable iCloud Drive
10. System Preferences Won't Open
- Force quit: Command + Option + Esc
- Delete preference pane cache:
- ~/Library/Caches/com.apple.preference*
- Reset NVRAM
- Boot in Safe Mode and try opening
- Create new user account to test
11. Software Won't Install
Installation Fails:
- Check Security Settings:
- System Settings → Privacy & Security
- Allow apps from: App Store and identified developers
- If blocked, click "Open Anyway"
- Right-click to Open:
- Right-click installer → Open
- Click "Open" in dialog
- Verify Installer:
- Download from official source only
- Check file isn't corrupted
Safe Mode
Boot into Safe Mode to troubleshoot software issues:
- Shut down Mac
- Turn on and immediately hold Shift
- Release when you see login screen
- Log in (may take longer than usual)
- Safe Mode:
- Only essential system extensions load
- Clears various caches
- Runs basic disk check
- Prevents login items from loading
- Test if issue persists in Safe Mode
- Restart normally
⚠️ Before Major Troubleshooting: Always backup your data first! Use Time Machine or manual backup before deleting system files or reinstalling macOS.
Recovery Mode
For serious software issues:
- Restart and hold Command + R
- Options in Recovery:
- Restore from Time Machine: Get your system back
- Reinstall macOS: Fresh OS install (keeps files)
- Disk Utility: Repair disk errors
- Safari: Access web for help
🎯 Quick Diagnostic: If an issue appears after installing new software, that software is likely the cause. Uninstall it and test. If issue appears after macOS update, wait for next update or reinstall macOS.
When to Reinstall macOS
Consider clean install if:
- Multiple persistent software issues
- Mac extremely slow despite troubleshooting
- System files corrupted
- Preparing to sell Mac
Important: Reinstalling macOS from Recovery keeps your files but reinstalls the OS. See our Clean Install Guide for details.