If MATLAB is not launching properly, and you are not receiving any License Manager Errors, then you may perform the following solutions:
- Check System Requirements
- Disable Security Software
- Regenerate Preferences
- Start MATLAB from the Installation Folder
- Provide MATLAB with Full Disk Access
- Conflicts with Cloud Storage
- Start MATLAB in Debug Mode
Check System Requirements
Ensure that your macOS meets the system requirements for the release of MATLAB you are attempting to launch. If you have recently updated to a new version of macOS, you may need to update to a newer version of MATLAB.
Disable Security Software
The security software on the machine may be interfering with MATLAB. To troubleshoot, try disabling any security software or reboot in safe boot.
Regenerate Preferences
One of the most common reasons for MATLAB to fail to launch is due to corrupted preferences. To regenerate your preferences, remove or rename your preferences directory then relaunch MATLAB:
- Open the Finder, the blue face on the dock
- In Finder, click on the “Go” menu and select “Go to Folder”
- Go to this folder: ~/Library/Application Support/MathWorks/MATLAB
- For R2016a and earlier: ~/.matlab
- Locate the folder that corresponds to your MATLAB version and delete/rename it. For example, rename “R2021a” to “R2021a_old”.
Note: Do not delete any folders that contain the word licenses in the folder name, e.g. R2021a_licenses. These folders contain important license information.
Once the folder has been renamed, try restarting MATLAB to regenerate the preferences.
Start MATLAB from the Installation Folder
The shortcut generated during the installation of MATLAB may be corrupted or broken. To troubleshoot if this is the cause of MATLAB's failure to launch, start MATLAB from the installation folder:
- Open the Finder, the blue face on the dock
- In Finder, click on the “Go” menu and select “Go to Folder”
- Go to this folder: /Applications/MATLAB_R20XXx.app/bin/
- Double click matlab
Note: The R20XXx must be edited to correspond to your install release of MATLAB, e.g. R2021a.
If MATLAB launches, you may create a new alias from the matlab executable in the /bin.
For some installations of MATLAB on Mac, the /Application shortcut does not work on the initial installation. A reinstall will resolve this but you can alternatively run the below .sh script which is included in any MATLAB installation:
/MATLAB_R20XXx.app/bin/maci64/registerwithOS
This script should rerun post-installation tasks such as fixing the /Applications shortcut.
Conflicts with Cloud Storage
If you have MATLAB in cloud storage or have its working folder in cloud storage, then you may need to grant full disk access to that cloud storage platform. Otherwise, move MATLAB or its working folder to a different location that is not using Cloud Storage.
Start MATLAB in Debug Mode
To start MATLAB in debug mode, launch MATLAB without the desktop environment. To do so, open a Terminal window (/Applications/Utilities/Terminal.app) and run the following command:
$MATLAB/bin/matlab -nodesktop
Where $MATLAB is the path to your MATLAB directory. For example, if you are using MATLAB R2021a and have installed MATLAB in the default directory, the command will be:
/Applications/MATLAB_R2021a.app/bin/matlab -nodesktop
If MATLAB starts, it will start in the Terminal window itself. The title of the Terminal window will change to say “MATLAB_maci64 -nodesktop.”
From the Terminal window, run the command “desktop” to attempt to start the MATLAB desktop environment. This will produce an error message which may help you to identify the problem. If you would like assistance in interpreting the error, please contact Installation and Licensing Support.
