Q100041: Mari launch issues



This article explains possible causes why Mari could have problems launching without providing a specific error message.


There are several possible causes for Mari not launching or crashing on launch.
The most common ones are:

1) Your machine is using Intel HD Graphics (not supported)
2) You do not have permissions for your config files
3) Your PYTHONHOME environment variable is set to a different Python version or an invalid directory.
4) Your machine has a 10th or 11th generation Intel CPU


1) Intel HD graphics are not supported by Mari. You will require an NVIDIA or AMD graphics card with the latest drivers. More details for system requirements can be found here. If you are using a laptop with 2 GPUs, this article explains how to assign your dedicated GPU to Mari.

2) Navigate to your Mari config folder and recursively change the permissions of the entire folder containing all files. The method of changing permissions can vary between OS. On Linux and Mac systems this is done best through the chmod command, whilst on Windows it is best to select the .mari folder in your home area and giving full access for your user account to this folder and all subfolders and files.
3) Mari 3.0 upgraded from Python 2.6 to Python 2.7. Many pipelines are built around the use of Python 2.6 and make use of the PYTHONHOME environment variable to point to a specific python install. If this variable is pointing to an invalid directory or out-of-date version of Python this might cause a crash or disable selected features. Unsetting the environment variable before the launch of Mari will solve those issues as Mari will use its own Python install.
4) There is currently a known issue with Mari and 10/11th generation Intel processors, which can cause crashes during launch or when loading projects. This can be prevented by setting the following environment variable:


Further information on this known issue and full instructions for applying the workaround can be found in the article linked below:

Q100573: Katana, Mari, and Nuke can fail to launch with a 10th or 11th Generation Intel CPU 



If you are still seeing any issues after performing the steps outlined in this article, then please open a Support ticket and let us know the issue you are encountering and the troubleshooting steps you have taken so far. The information we require to investigate is outlined under Q100090: Reporting a Mari issue .
For more information on how to open a Support ticket, please refer to the 'Using the Support Portal' article.

    We're sorry to hear that

    Please tell us why