Home › Knowledgebase › KB-934

How to fix macOS app crashes or crashes on launch after a macOS update

Summary

This guide helps you troubleshoot and resolve: How to fix macOS app crashes or crashes on launch after a macOS update. Follow the steps below to fix the issue.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

Common Causes

After installing a macOS update, some applications may crash immediately upon opening or fail to launch altogether. This is typically caused by outdated app permissions, incompatible system extensions, or corrupted preference files. Follow the steps below to restore normal functionality to your Mac.

Check app compatibility

Before troubleshooting, confirm that the application is compatible with your current version of macOS. Check the developer's website to ensure the app supports your macOS version and your Mac's processor architecture (Apple Silicon or Intel).

To check your Mac's processor:

  1. Click the Apple menu () and select System Settings.
  2. Select General from the sidebar.
  3. Click About.
  4. Look for the Chip or Processor entry to identify if your Mac uses Apple Silicon or Intel.

If you use Australian business software such as MYOB, Xero, or QuickBooks Online, verify that your subscription and desktop components are updated to versions compatible with the latest macOS release.

Update the affected application

  1. Open the App Store from your Dock or Applications folder.
  2. Click Updates in the sidebar.
  3. If an update is available for the crashing app, click Update.
  4. If you downloaded the app from a developer's website, visit their support page to download the latest version compatible with your current version of macOS.

Update macOS

  1. Click the Apple menu () and select System Settings.
  2. Select General from the sidebar.
  3. Click Software Update.
  4. If an update is available, click Update Now or Restart Now.
Note: Administrator credentials may be required to install macOS updates or change settings in System Settings.

Reset app permissions

  1. Click the Apple menu () and select System Settings.
  2. Select Privacy & Security from the sidebar.
  3. Review the sections under Privacy, such as Files and Folders, Screen Recording, or Accessibility.
  4. Locate the affected app in the list and ensure the toggle switch is enabled.
  5. If the app was already enabled, toggle it off, restart your Mac, and then toggle it back on.

Remove incompatible login items and extensions

  1. Open System Settings.
  2. Navigate to General > Login Items & Extensions.
  3. Under Allow in the Background and Open at Login, identify items related to the crashing app.
  4. Select the item and click the Remove (-) button.
  5. Restart your Mac and attempt to open the application again.

Check for unidentified developer apps (Gatekeeper)

macOS Gatekeeper may block apps from unidentified developers after a system update, causing crashes or failure to launch.

  1. Click the Apple menu () and select System Settings.
  2. Select Privacy & Security from the sidebar.
  3. Scroll to the Security section.
  4. If a message indicates the app was blocked because it is from an unidentified developer, click Open Anyway next to the app's name.
  5. Enter your administrator password if prompted and confirm you want to open the app.
Warning: Only open apps from unidentified developers if you trust the source. Opening unverified software can expose your Mac to security risks.

Reset the application's preference files

Warning: Back up any preference files before deletion. Copy the files to a separate folder on your Desktop so you can restore them if needed. Deleting preference files may reset your app settings to default. You may need to sign in again or reconfigure your preferences after performing these steps.
  1. Open Finder.
  2. In the menu bar, click Go > Go to Folder....
  3. Enter the following path: ~/Library/Preferences
  4. Locate files associated with the crashing app (usually named com.developer.appname.plist).
  5. Copy these files to a backup location on your Desktop.
  6. Move the original files to the Trash.
  7. Restart your Mac and launch the application; macOS will create fresh preference files.
Tip: If you are unsure which preference file belongs to the app, look for files that begin with the developer's domain name or the app's name.

Run First Aid in Disk Utility

If the crash is related to disk permissions or file system issues, running First Aid may resolve the problem.

  1. Open Finder and go to Applications > Utilities.
  2. Open Disk Utility.
  3. Select your startup disk (usually named Macintosh HD or Apple SSD) from the sidebar.
  4. Click the First Aid button in the toolbar.
  5. Click Run to begin checking and repairing disk permissions and volume errors.
  6. When complete, restart your Mac and test the application.

Check crash logs in Console.app

If the app continues to crash, Console.app can help identify the specific cause by showing system crash reports.

  1. Open Finder and go to Applications > Utilities.
  2. Open Console.
  3. In the sidebar, select Crash Reports.
  4. Look for entries matching the name of the crashing app and the time of the crash.
  5. Select a report to view the details. Look for mentions of missing libraries, incompatible code, or specific error codes.
  6. Provide this information to your IT support team when opening a ticket.

Troubleshoot in Safe Mode

Safe Mode starts your Mac with only essential system software, which can help determine if a third-party app or extension is causing the crash.

Apple Silicon Macs

  1. Shut down your Mac completely.
  2. Press and hold the power button until you see Loading startup options.
  3. Select your startup disk.
  4. Press and hold the Shift key, then click Continue in Safe Mode.
  5. Your Mac will restart and display Safe Boot in the menu bar.

Intel-based Macs

  1. Shut down your Mac completely.
  2. Press the power button, then immediately press and hold the Shift key.
  3. Release the key when you see the login window.
  4. Log in to your Mac. You should see Safe Boot in the menu bar.

Once in Safe Mode, attempt to open the crashing application. If the app works in Safe Mode, a login item, extension, or third-party system modification is likely causing the issue. Restart your Mac normally to exit Safe Mode.

Troubleshooting by user scope

App crashes on launch for all users

If the app crashes for every user account on the Mac, the issue may be with the application installation itself.

  1. Drag the application from the Applications folder to the Trash.
  2. Empty the Trash.
  3. Download a fresh copy of the application from the official developer's website.
  4. Install the app and launch it to see if the issue persists.

App crashes only for one user

If the app works for other users but not your account, the issue is likely within your user library.

  1. Open Finder.
  2. Click Go > Go to Folder....
  3. Enter: ~/Library/Containers
  4. Look for folders named after the app or its developer and move them to the Trash.
  5. Restart your Mac and try opening the app again.
Caution: Deleting preference or container files may reset your app settings to default. You may need to sign in again or reconfigure your preferences after performing these steps.

If you have completed all the steps above and the application continues to crash, please Open a Ticket with our support team for further assistance.

Still Having Issues?

Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.

💻 Open a Ticket