MainStage 3: Troubleshooting basics

If MainStage 3 isn't performing as expected, try these general troubleshooting steps.

Check out the MainStage 3 documentation

It's always a good idea to review the product documentation to better understand how MainStage 3 behaves. Some behaviors may not be issues that you need to troubleshoot. The user guides are available from the Help menu in MainStage 3, or as a PDF.

Confirm requirements and versions

  • Make sure that you haven't overlooked any hardware aspect that's required to use MainStage 3.
  • Update to the latest software version. Click the Updates button on the Mac App Store and install any available updates. This ensures that your software has the latest improvements and enhancements. See MainStage 3: Best practices for updating for more information.
  • Check compatibility and driver versions for devices not manufactured by Apple ("third-party"). You can check the third-party product manufacturer's website to be sure that you're using the latest version of the relevant driver or other software for your product. This advice applies to an audio interface, MIDI interface, storage system, control surface, or plug-ins. Learn more about troubleshooting possible issues with Audio Unit plug-ins.

Test with the computer's built-in audio

If you use external audio hardware, try setting MainStage to use the built-in audio hardware on your computer. Choose MainStage > Preferences > Audio, then click the Audio pane. Choose Built-in Input and Built-in Output from the Audio Input and Output pop-up menus. If the issue doesn't occur when using built-in audio, refer to the manufacturer of your audio interface.

Create a new concert

Sometimes concert files can become unusable, causing unexpected behavior in MainStage. Choose File > New and select a template in the template selector window. Test to see if the issue occurs in the new concert.

Try a different user account

See Isolating an issue by using another user account.

Delete user preferences

Before you reset user preferences, be sure to first review your MainStage preferences and note non-default settings you've chosen. When resetting the MainStage 3 preferences, these preferences will return to default. For more information on preferences, see Preferences overview in the MainStage 3 User Guide. 

To reset your MainStage 3 user preference settings to their original state:

  1. Quit MainStage 3 if it's open.
  2. In the Finder, choose Go > Go to Folder from the menu.
  3. Type: ~/Library/Preferences
  4. Click the Go button.
  5. Remove the com.apple.mainstage3.plist file from the Preferences folder.
  6. Restart the computer.

Or, you can quit MainStage, open Terminal, then execute this command:

defaults delete com.apple.mainstage3

After resetting the preferences to default, see if the issue still happens. If it's fixed, set your preferences back to how you had them and test again.

Reinstall MainStage

If an issue persists, you might consider reinstalling MainStage. To reinstall a fresh copy of MainStage:

  1. Delete MainStage from the /Applications folder.
  2. Open the Mac App Store and re-download MainStage from the Purchases section.

For more information about settings and installation refer to the MainStage 3 User Guide.

For issues installing the additional content, see Logic Pro X, MainStage 3: Issues installing additional content.

Information about products not manufactured by Apple, or independent websites not controlled or tested by Apple, is provided without recommendation or endorsement. Apple assumes no responsibility with regard to the selection, performance, or use of third-party websites or products. Apple makes no representations regarding third-party website accuracy or reliability. Risks are inherent in the use of the Internet. Contact the vendor for additional information. Other company and product names may be trademarks of their respective owners.

Published Date: